Updated

How to generate a token for the Manychat API and where to get parameters

This article explains how to generate a token for the Manychat API and where to get parameters. The following questions will be covered:

The URL to the website listing all the API commands can be found here.

What is API Key? 

API Key is a code used to identify the user, developer, or calling program for a website. Manychat provides API Key (available on certain paid plans) to use with the Account Public API. Public API Key can be found in Settings → API.

There is also a Profile Public API that's used for connection to non-bot-specific things like Templates. It requires a different key that can be found here.

How to generate and authorize API Key

To use the Manychat API, you need to generate an API Key. Navigate to Settings → API and click Generate your API Key button.

⚠️ Note: Refreshing and deleting your token will disable all connected API methods.

After a successful token generation, you can use our Swagger to experiment with API. It is available here. 

 

To add your token to Swagger, click the Authorize button:

To authorize your token, paste your API Key as a Bearer value and click Authorize:

You also can regenerate or delete your API Key in the Settings tab. 

Where can I get parameters (like tag ID)?

Contact ID can be found in a contact card in Contacts:

Flow_ns can be found in your Automation URL in the address bar:

Tag ID – use /fb/page/getTags API method to get a list of all Tag IDs. You can also find it in the interface by proceeding to Settings → Tags and hovering the cursor over the desired tag.

Custom User Field ID – use /fb/page/getCustomFields API method to get a list of all User Field IDs. You can also find it in the interface by proceeding to Settings → Fields → User Fields and hovering the cursor over the desired user field.

to-1.png

Is there any limit to the number of API calls?

Yes, Manychat has a request-based limit. Refer to the table below for details. When you reach the limits, Manychat may stop processing requests for 24 hours.

PAGE

/fb/page/getInfo

/fb/page/getTags

fb/page/getGrowthTools 

/fb/page/getCustomFields 

/fb/page/getOtnTopics

/fb/page/getBotFields 

100RPS

PAGE

/fb/page/getFlows

10RPS

PAGE

/fb/page/createTag

/fb/page/removeTag

/fb/page/removeTagByName

/fb/page/createCustomField

/fb/page/createBotField

/fb/page/setBotField

/fb/page/setBotFieldByName

/fb/page/setBotFields

10RPS

SENDING

/fb/sending/sendContent

/fb/sending/sendContentByUserRef

/fb/sending/sendFlow

25RPS

SUBSCRIBER

/fb/subscriber/getInfo

/fb/subscriber/findByName

/fb/subscriber/findByCustomField

10RPS

SUBSCRIBER

/fb/subscriber/findBySystemField

100RPS

SUBSCRIBER

/fb/subscriber/addTag

/fb/subscriber/addTagByName

/fb/subscriber/removeTag

/fb/subscriber/removeTagByName

/fb/subscriber/setCustomField

/fb/subscriber/setCustomFields

/fb/subscriber/setCustomFieldByName

/fb/subscriber/verifyBySignedRequest

/fb/subscriber/createSubscriber

/fb/subscriber/updateSubscriber

10RPS
 

Was this article helpful?