Get subscriber with the Manychat API
Returns one contact with name, email, phone, WhatsApp, Instagram username, opt-ins, last interaction, custom fields and tags.
- Identifier
- manychat_get_subscriber
The request
POST https://connect.reportei.com/api/tools/manychat_get_subscriber/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"subscriber_id": 1
}
}Your system sends your customer's connection id and the tool arguments. The headers are the same as the rest of the Connect API: your product's token and your customer's token.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| subscriber_id | integer | Yes | ID of the contact, from Get subscriber by email or phone, Search subscribers by name or Create subscriber. The responses bring it as text; send it as a number. |
Supported connections
Your customer connects their Manychat account once, with one of the modes below. The same connection serves every tool of the toolkit.
API key
Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.
The response
On success, Connect preserves the app's response status and body. HTTP errors returned by the app use the {error, api_error} envelope; authentication or validation can fail before execution. The X-Toolkit-Execution-Id header identifies the recorded execution, available at GET /api/tools/executions/{uuid}.
Ready for AI agents
This tool's input is a JSON Schema, available at GET /api/tools/manychat_get_subscriber. It becomes your agent's tool definition with no conversion.
Other Manychat tools
- Get subscriber by email or phoneGETReturns the contact with this email address or phone number, with the same fields as Get subscriber. Send email or phone, not both.
- Search subscribers by nameGETReturns up to 100 contacts whose full name matches, with the same fields as Get subscriber.
- Create subscriberPOSTCreates a contact with an email, an SMS phone or a WhatsApp phone, at least one of them, and returns it with its id. Each channel sent needs its opt-in: has_opt_in_email for email, and has_opt_in_sms with consent_phrase for phone.
- Update subscriberPOSTUpdates the name, email, phone, gender or opt-ins of a contact. Changing email or phone needs its opt-in again: has_opt_in_email for email, and has_opt_in_sms with consent_phrase for phone.
- List tagsGETLists the tags of the account with their id and name.
- Create tagPOSTCreates a tag in the account and returns it with its id.
- Apply tagPOSTApplies a tag to a contact. Automations of the account that start when this tag is applied run for the contact.
- Remove tagPOSTRemoves a tag from one contact. The tag stays in the account and on the other contacts.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
