Release Candidate — the API is undergoing final validation before general availability, and minor changes may still occur.
Hellomateo API Documentation
Campaigns

Get Campaign Recipient by Locator

GET
/v1/campaigns/{campaign_id}/recipients/by

Returns the requested campaign Recipient by Locator.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

campaign_id*string

Unique identifier of the related campaign.

Formatuuid

Query Parameters

external_id?||

Identifier assigned by an external system.

secondary_external_id?||

Secondary identifier assigned by an external system.

email_address?|

Filters resources by email address.

sms_phone_number?|

Filters resources by sms phone number.

whatsapp_phone_number?|

Filters resources by whatsapp phone number.

facebook_user_id?|

Unique identifier of the related facebook user.

instagram_user_id?|

Unique identifier of the related instagram user.

postal_address?|

Filters resources by postal address.

include?array<"contact" | "channel">

Additional fields to include in the response. Use repeated query syntax: include=foo&include=bar.

Response Body

application/json

curl -X GET "https://api.getmateo.com/v1/campaigns/497f6eca-6276-4993-bfeb-53cbbbba6f08/recipients/by"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "campaign_id": "78614b6c-fe7c-41e2-8e25-c9b3a3c91904",  "contact_id": "f245e2a3-e141-4d41-912c-b1c1f5bd5598",  "status": "sent",  "error_code": "string",  "channel_id": "bbe8aa76-a4bb-46f6-a785-df8e831cc459",  "channel_type": "email",  "send_after": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "contact": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "display_name": "string",    "full_name": "string",    "salutation": "string",    "birthday": "2019-08-24T14:15:22Z",    "description": "string",    "external_id": "string",    "secondary_external_id": "string",    "address_line1": "string",    "address_line2": "string",    "city": "string",    "zipcode": "string",    "country": "string",    "is_blocked": true,    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z"  },  "channel": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "inbox_id": "5127f22b-d152-46dd-aeaa-3a852d9fbfc2",    "name": "string",    "handle": "string",    "type": "email",    "status": "active",    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z"  }}