List all conversation messages for a specific lead
GET/v1/leads/:leadID/conversations
Retrieve all conversation messages for a given lead ID.
{leadID} is either the numeric lead id or the external_id, which is the data.id returned by POST /v1/webhooks/leads. Without id_type, a value that is not a positive integer is looked up as an external_id; a positive integer is looked up as both, and if it names two different leads the request fails with 409 lead_ambiguous: repeat it with ?id_type=lead_id or ?id_type=external_id. Right after an asynchronous intake the lead can return 404 for a few seconds; retry with backoff.
Request
Responses
- 200
- 400
- 404
- 409
- 500
OK
Bad Request
Not Found
error_code lead_ambiguous
Internal Server Error