Skip to documentation
Dashboard
Contacts

Delete a contact

Permanently remove a contact and its list memberships from your workspace.

DELETE/api/v1/contacts/{contactId}
On this page

Authentication

Send a RouteKite API key as a Bearer token. This endpoint requires the audience:write scope.

Required headers
NameTypeRequirementDescription
AuthorizationstringRequiredBearer rk_ API key. The key determines the workspace.
Idempotency-KeystringRequired8 to 200 characters. Reuse only when retrying the same operation with the same input.

Path parameters

Path parameters
NameTypeRequirementDescription
contactIdUUIDRequiredID of the contact in your workspace.

Response

Response fields
NameTypeRequirementDescription
objectstringAlwaysAlways deleted.
idUUIDAlwaysThe deleted contact ID.
deletedbooleanAlwaysTrue when deletion succeeded.

Choose the contact

Use the ID returned when listing or creating a contact. Deletion cannot be undone.

Writes and retries

The API key must have been created by a current workspace member. Use a unique Idempotency-Key for each intended write. Reuse it only when retrying the same operation with the same input.

Errors

StatusCodeWhat it meansWhat to do
400INVALID_REQUESTOne or more request fields are invalid.Correct the request and retry.
401UNAUTHORIZEDThe API key is missing or invalid.Send a valid Bearer API key.
403FORBIDDENThe key does not have the required scope.Use a key with the scope shown above.
429RATE_LIMITEDThe API key or workspace has reached its request limit.Wait for the Retry-After interval before retrying.
503RATE_LIMIT_UNAVAILABLERouteKite could not check request limits.Retry shortly.
500INTERNAL_ERRORRouteKite could not complete the contact operation.Retry shortly. Reuse the same Idempotency-Key for write retries.
400IDEMPOTENCY_KEY_REQUIREDThe write needs a stable idempotency key.Send an Idempotency-Key of 8 to 200 characters.
403API_KEY_ACTOR_UNAVAILABLEThe API key has no current workspace member as its creator.Use a key created by a current member.
409IDEMPOTENCY_CONFLICTThis idempotency key was used with different input.Reuse the original input for a retry. Use a new key for a new write.
409OPERATION_IN_PROGRESSAn identical write is already in progress.Retry shortly with the same key and input.
503OPERATION_UNAVAILABLERouteKite could not complete the write.Retry with the same key and input.
404CONTACT_NOT_FOUNDThe contact does not exist in this workspace.Check the ID using List contacts.
409CONTACT_DELETE_FAILEDThe contact could not be deleted.Check whether the contact still exists before retrying.