SendPulse service REST 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 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:

https://api.sendpulse.com

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