Existing contacts
When doing an insert, the API will return an error with a response indicating a duplicate contact, if the contact you're attempting to insert already exists in the database. Duplicates are checked by the contact's email address. In this case you can update the contact record.
Consent
Be sure to add a consent_status field otherwise you won't be able to send emails to contacts.
Response
After a successful contact insert the Envoke contact ID is returned. This ID can be used to update the contact later.
Contact fields
View available contact fields that you can insert / update with the API
All example below show the POST URL followed by the POST data. Each example below also includes a cURL request. Make sure to change the API_ID and API_KEY with your values.
Endpoint: /contacts
HTTP method: POST
URL: https://e1.envoke.com/v1/contacts
Supply the full contact object JSON in the POST data. Example:
https://e1.envoke.com/v1/contacts
{
"email" : "new-contact@api-testing.com",
"first_name" : "John"
}curl -X POST -u API_ID:API_KEY -d "{\"email\":\"new-contact@api-testing.com\",\"first_name\":\"John\"}" "https://e1.envoke.com/v1/contacts"