Welcome to the official BirdSend API documentation. Our RESTful API lets your app to manage contacts, create and send emails, set up automation, and many more. The best thing is that you can use the programming language that you already know and love.
Let's Build Your App
BirdSend API platform includes numerous resource-oriented endpoints to help you enrich your app. API responses will be returned in JSON, and all parameters passed to the request body must be formatted in JSON. Our API uses HTTP response codes to indicate errors.
Base API URL
Below is the base API URL or the root endpoint:
For example, API request endpoint to obtain the list of contacts is
/contacts so the full URL for the request will be
The version part of the base API URL above (v1 in this case) indicates the current version of our API. In the future, if we increment the version, the version part of the base URL will be changed too (e.g. https://api.birdsend.co/v2).
NOTE: Future API updates will be backwards compatible for a specific amount of time (e.g. months) to give you time to migrate to the new API version.
Create and Manage API Applications
Please login to the BirdSend developer area to register your first application or manage/edit your existing applications. If you don't have a BirdSend user account, you can sign up for the developer account here.
NOTE: If you're an existing BirdSend User, you don't need to create a developer account but you can login to your exisiting BirdSend account, and go to
Settings > API Integration
Throttling and Rate Limiting
To ensure a great experience for all our users and developers, we have to limit the API connection requests. Each account is permitted up to 5 requests per second. If you exceed your rate limit, the API will return a 429 Too Many Requests HTTP response code.
Please review our Best Practices section to make sure your integration with BirdSend API is as reliable as possible.