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 by detailed documentation.
Web hooks are available by request. Please contact us at support@sendpulse.com if you want them enabled for your account.
Wrappers for SendPulse API and code samples
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 come back in the form of JSON structures.
The limit on the requests number is 3 requests per second.
SendPulse API wrappers
The latest versions of SendPulse API wrappers are available at GitHub.
Main URL
All references to API requests in this document include the compulsory basic URL:
Authorization
The authorization process is only possible when preceded by a private key, which, in future, should be referenced in each request to the API.
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 |
A sample response:The resulting key is valid for 1 hour and does not require additional requests with each operation. At the end of the license period (1 hour), you must send a request to obtain a new key.
{
"access_token": "tf4Si1LydYpTAPyHXUgjig72jlrd5HpIJL5oigmc",
"token_type": "Bearer",
"expires_in": 3600
}
A sample key:
Authorization: Bearer tf4Si1LydYpTAPyHXUgjig72jlrd5HpIJL5oigmc
Error codes and description
Error code | Description |
8 | Empty data |
10 | Empty sender email address |
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 | You are not allowed to use free mail services |
21 | Can’t find email address on activation |
97 | Invalid email address type. You are not allowed to use free mail services. |
201 | Empty mailing list name |
203 | This mailing list name already exists |
213 | Mailing list not found |
303 | Can’t find email addresses in the mailing list |
400 | Can’t find such SMTP user. Please, create SMTP service account. |
502 | Can’t find email address |
602 | Can’t find campaign. Probably, it has already been sent. |
701 | Empty sender name or email address |
703 | Can’t find mailing list |
704 | Can’t find sender |
707 | Not enough funds on your account balance |
711 | You should wait for 15 minutes before creating new campaign on the same mailing list. |
720 | Empty subject field |
721 | Empty email message content field |
722 | Can’t find mailing list ID |
799 | Wrong send date. It must be in such format: Y-m-d H:i:s and can not be less than the current date |
800 | Invalid operation |
802 | Can’t find campaign |
901 | Empty sender name field |
902 | Chosen email address is already used |
903 | Empty sender email address field |
904 | Email address is blacklisted |
905 | You have reached the limit of available sender addresses |
906 | Email address syntax error |
1101 | Empty email address field |
1003 | The specified sender doesn’t exist |
1004 | Activation code was sent. You should wait for 15 minutes before the next try. |
1005 | Confirmation sending error |
1104 | Can’t find activation code |
Sign up with
Facebook