✦ DEVELOPER HUB

SMMpro REST API

Integrate powerful email delivery directly into your application. Our API is built on REST principles and returns JSON-encoded responses.

Documentation

Authentication

Authenticating with the SMMpro API is simple. Include your API key in the X-API-Key header of every request.

CURL REQUEST

curl -H "X-API-Key: YOUR_KEY" https://api.smmpro.email/v1/subscribers

Subscribers

GET /api/v1/subscribers

Retrieve a list of subscribers with optional filtering.

Param	Type	Description
list_id	int	Filter by list ID
status	string	subscribed, unsubscribed, bounced
page	int	Default: 1

POST /api/v1/subscribers

Add a new subscriber to a specific list.

                                JSON PAYLOAD
                            
                                {

                                  "email": "customer@example.com",

                                  "list_id": 42,

                                  "first_name": "John"

                                }

DELETE /api/v1/subscribers?api_id={ID}

Unsubscribe a member from your platform.

Campaigns

GET /api/v1/campaigns

List all your email campaigns and their current status.

POST /api/v1/campaigns

Create a new draft campaign.

REQUIRED FIELDS

                                { "name", "subject", "list_id", "from_email", "html_body" }

POST /api/v1/campaigns?api_id={ID}&api_action=send

Queue a draft campaign for immediate delivery.

Subscriber Lists

GET /api/v1/lists

Fetch all your subscriber lists and member counts.

POST /api/v1/lists

Create a new audience list container.

Analytics

GET /api/v1/analytics?api_id=overview

Get global performance metrics including total sent, opens, and clicks.

Error Codes

Our API uses standard HTTP response codes to indicate success or failure.

CODE	DESCRIPTION
`UNAUTHORIZED`	Invalid or missing API Key.
`NOT_FOUND`	The requested resource does not exist.
`RATE_LIMIT`	Too many requests in a short period.