Emails. Done.

API v1 Stable

Get contact

Returns one contact by email or contact id.

POST Stable

Get contact

/v1/contacts/get

Reads tenant-level contact metadata and delivery summary.

Request

Name Type Required Description Example
emailOrContactId string Yes Contact email or contact id. user@example.com

curl

curl -X POST 'https://api.emailsdone.dev/v1/contacts/get' \
  -H 'Authorization: Bearer ed_...' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response

Name Type Required Description Example
ok boolean Yes True when contact was read.
contact object Yes Contact record. 
{}

Errors

StatusCodeMessage
400 invalid_request Request body failed validation.
401 missing_api_key Authorization bearer token is missing.
401 invalid_api_key API key is invalid.
403 api_key_revoked API key has been revoked.
404 contact_not_found Contact was not found.
405 method_not_allowed Only POST is allowed.
500 internal Unexpected server error.

Notes

  • Contacts are tenant-level recipients for app email history, not CRM records.
  • Existing environment API keys can access tenant contacts endpoints.