# Delete contact

Delete a contact.

# Method

DELETE

# Path

/contacts/[phone_number]

# Path parameter

Name Value Required?
phone_number Phone number starting with the country code with or without leading plus. e.g. +16175551212 or 16175551212 Yes

# Body parameters

Name Value Data type Required?
list_id 0 - to delete the contact (including from all the contact lists) or
List ID - to delete only from a contact list (List ID is the value shown in the address bar when a list is selected on the Contacts page)
Integer No (defaults to 0)

# Response

# HTTP status codes

Code Remarks
200 Request was successful.
400 Validation error or request body was incorrectly formatted.
401 Authentication failed. Check apikey header.
404 Requested API endpoint not found.
429 The rate limit has been reached.
500-511 There was a problem processing the request on our server. Try again later.

# Response object

Name Value Remarks
status success or error -
errors Array of object { msg: [error detail] } Only present when status is error

# Code sample

curl --location --request DELETE 'https://api.sociocs.com/contact/16175551212' \
--header 'apikey: [your api key]'
--header 'Content-Type: application/json' \
--data-raw '{
    "list_id_": 0
}'