1. Home
  2. Integrations
  3. API
 

Introduction


Our API interface is used to integrate SendPulse’s distribution service capabilities with client’s personal projects.

The API is designed for developers and is accompanied with a detailed documentation.

Description

SendPulse’s REST API service works over the HTTP protocol and is essentially a set of methods that are used to perform requests and receive responses for each operation.

All answers return in the form of JSON structures.

The rate limit is 10 requests per second.

Cross Domain Queries (jQuery Ajax Example) are not allowed

 

SendPulse API libraries

The latest versions of SendPulse API client libraries are available at GitHub.

 

API endpoint

All references to API requests in this document include the root URL:

https://api.sendpulse.com

Authorization

Authorization process requires a personal key signing each further API request.

The necessary parameters to obtain the key can be found in the private account settings page found on the following URL 

https://login.sendpulse.com/settings in the API tab.

The following parameters are used:

grant_type has to be equal to client_credentials
client_id your ID (API)
client_secret your secret (API)

To get the key you have to send a POST request to:

https://api.sendpulse.com/oauth/access_token

The resulting key is valid for 1 hour and does not require additional requests for each operation. Request for a new key must be sent before the current key expires.

The key code (the token) must be sent in the header of all requests except for requests for getting the token itself (when the key is not required).

A sample response:

{
  "access_token": "tf4Si1LydYpTAPyHXUgjig72jlrd5HpIJL5oigmc",
  "token_type": "Bearer",
  "expires_in": 3600
}

A sample key:

Authorization: Bearer tf4Si1LydYpTAPyHXUgjig72jlrd5HpIJL5oigmc

 

Error codes and description

Error code Description
8 No data
10 Sender email address missing
11 Can’t find recipients addresses
13 Empty email message content field
14 Can’t find email address with a specified ID
17 Can’t find email address
19 Email address already exists
20 Using free email services not allowed
21 No such email address awaiting activation
97 Invalid email address type. Using free email services not allowed.
201 Empty mailing list name
203 This mailing list name already exists
211 Mailing list empty
213 Mailing list not found
303 Can’t find email addresses in the mailing list
400 Specified SMTP user doesn’t exist. Create an SMTP account.
502 Can’t find email address
602 Can’t find campaign. Probably, it has already been sent.
701 Sender email address or name not specified.
703 Can’t find mailing list
704 Can’t find sender
707 Account balance exceeded
711 Wait 15 minutes before sending to the same list again
720 Empty subject field
721 Email message empty
722 Mailing list ID not specified
791 API-campaigns limit exceeded (5 per hour)
799 Incorrect date format. Use YYYY-MM-DD hh:ii:ss that equals or greater than the current date
800 Invalid operation
802 Campaign not found
901 Sender name not specified
902 Selected email address already in use
903 Sender email address not specified
904 Email address blacklisted
905 Sender address quota reached
906 Email address syntax error
1101 Email address not specified
1003 Specified sender doesn’t exist
1004 Activation code has been sent. Wait 15 minutes to retry
1005 Error sending confirmation
1104 Activation code not specified