Smartlead MCP Server

🚀 Smart Leadership API Documentation

This API documentation provides a detailed guide on using the Smart Leadership API, including getting started, API basics, functional modules, and more.

🚀 Quick Start

To use the Smart Leadership API, follow these steps:

1. Register a Developer Account: Visit the official website and create a developer account.
2. Get an Access Token: After logging in, go to the "My Apps" section, create a new app, and obtain an API access token.
3. Start Using: Start making API calls with the obtained token.

📚 Documentation

API Basics

Base URL

All API requests should be sent to:

https://api.smartlead.com/v1

Request Headers

Each request must include the following headers:

• Authorization: Bearer <access_token>
• Content-Type: application/json

Response Format

The API returns data in JSON format. The response status codes are as follows:

• 200: Success
• 401: Unauthorized
• 403: Forbidden
• 404: Resource Not Found
• 500: Server Error

Functional Modules

Create a Campaign

Create a new marketing campaign.

Request URL

POST /campaigns

Request Parameters

Response Example

{
  "id": "654321",
  "name": "Summer Promotion Campaign",
  "status": "active"
}

Get All Campaigns

List all created campaigns.

Request URL

GET /campaigns

Response Example

[
  {
    "id": "654321",
    "name": "Summer Promotion Campaign",
    "status": "active"
  },
  ...
]

Email Account Management

Add an Email Account

Add an existing email account to a campaign.

Request URL

POST /campaigns/{id}/email-accounts

Request Parameters

Update Email Account Settings

Update the configuration of an email account in a campaign.

Request URL

PUT /campaigns/{id}/email-accounts/{emailAccountId}

Request Parameters

Remove an Email Account

Remove a specified email account from a campaign.

Request URL

DELETE /campaigns/{id}/email-accounts/{emailAccountId}

Lead Management

Add Leads to a Campaign

Add multiple leads to a campaign.

Request URL

POST /campaigns/{id}/leads

Request Parameters

Response Status Codes

All API calls return the following status codes:

• 200: Success
• 401: Unauthorized
• 403: Forbidden
• 404: Resource Not Found
• 500: Server Error

📄 License

This API documentation is licensed under the MIT License, which allows users to use and modify the code for free, provided that the copyright notice is retained.

For more information, please contact the support team or refer to the developer forum.