Contacts
Delete a Contact Identifier
DELETE /v3/marketing/contacts/{contact_id}/identifiers
Base url: https://api.sendgrid.com
This endpoint can be used to delete one identifier from a contact.
Deletion jobs are processed asynchronously.
Note this is different from deleting a contact. If the contact has only one identifier, the asynchronous request will fail. All contacts are required to have at least one identifier.
The request body field identifier_type
must have a valid value of "EMAIL", "PHONENUMBERID","EXTERNALID", or "ANONYMOUSID".
Authentication
- API Key
Headers
Request Body
A type of the following: EMAIL, PHONENUMBERID, EXTERNALID, or ANONYMOUSID.
The value of the identifier you want to remove from the contact.
{
"identifier_type": "PHONENUMBERID",
"identifier_value": "+14152279968"
}
Path Parameters
Must be set to the contact_id
of the contact you want to remove the identifier from.
Responses
Indicates that the deletion is queued for processing. Check the job status with the Import Contacts Status endpoint.
The deletion job ID.
the error message
the field that generated the error
helper text or docs for troubleshooting
{
"errors": [
{
"field": "field_name",
"message": "error message"
}
]
}
the error message
the field that generated the error
helper text or docs for troubleshooting
{
"errors": [
{
"field": "field_name",
"message": "error message"
}
]
}
the error message
the field that generated the error
helper text or docs for troubleshooting
{
"errors": [
{
"field": "field_name",
"message": "error message"
}
]
}
Need some help?
We all do sometimes. Get help now from the Twilio SendGrid Support Team.
Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.