Create Contact
The Sendblue API allows you to create a new contact with the specified details.
Create Contact
To create a new contact, make a POST request to the following endpoint:
POST https://api.sendblue.co/accounts/contacts
Request Parameters
firstName
(string): The first name of the contact.lastName
(string): The last name of the contact.number
(string): The phone number of the contact.companyName
(string, optional): The company name of the contact
Sample Request
curl --location --request POST 'https://api.sendblue.co/accounts/contacts' \
--header 'sb-api-key-id: YOUR_SB_API_KEY_ID' \
--header 'sb-api-secret-key: YOUR_SB_API_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{
"firstName": "John",
"lastName": "Doe",
"number": "+19999999999",
"companyName": "ACME Inc"
}'
Here is the same in Node.js with Axios
const axios = require("axios");
const url = "https://api.sendblue.co/accounts/contacts";
axios
.post(
url,
{
firstName: "John",
lastName: "Doe",
number: "+19999999999",
companyName: "ACME Inc",
},
{
headers: {
"sb-api-key-id": "YOUR_SB_API_KEY_ID",
"sb-api-secret-key": "YOUR_SB_API_SECRET_KEY",
},
}
)
.then((response) => {
console.log(response.data);
})
.catch((error) => {
console.error(error);
});
Sample Response
{
"status": "OK",
"contact": "BUjbHDKzAQqs9M6bWAq5",
"contactData": {
"account_email": "[email protected]",
"firstName": "John",
"lastName": "Doe",
"phone": "+19999999999",
"displayPhone": "+1 9 999 999 9999",
"companyName": "ACME Inc"
}
}
Possible Error Responses:
-
If the contact already exists:
{
"status": "ERROR",
"message": "Contact already exists"
} -
If the phone number is invalid:
{
"status": "ERROR",
"message": "Invalid phone number"
} -
For other internal server errors:
{
"status": "ERROR",
"message": "Internal server error message"
}
Please make sure to replace placeholders like YOUR_SB_API_KEY_ID and YOUR_SB_API_SECRET_KEY with your actual API credentials in the sample requests.