ManyChat Page API

Page-level configuration for a connected ManyChat page: connected page info, tags, typed custom user field definitions, global bot fields, automations (flows) and folders, growth tools and One-Time Notification topics. 16 operations. Reads are limited to 100 queries per second and writes to 10; getFlows is the exception at 10 q/s. removeTag and removeTagByName delete the tag from the page and every subscriber carrying it and cannot be undone.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/manychat-page-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

manychat-page-api-openapi.yml Raw ↑
openapi: 3.0.0
info:
  title: ManyChat Page API
  description: 'The ManyChat Page API, split by tag from the Swagger document ManyChat publishes at https://api.manychat.com/swagger
    (the underlying JSON is served from https://api.manychat.com/swagger/compileJson?type=Page_API). Authentication is an
    API key generated per page in Settings > API, sent as `Authorization: Bearer <page-id>:<api-key>`. Per-operation rate
    limits are published by ManyChat in each operation description. Operation IDs here are the readable API Evangelist refinement;
    the provider''s generated hash ID is preserved on each operation as `x-provider-operation-id`.'
  version: beta
  contact:
    name: ManyChat
    url: https://api.manychat.com/swagger
  x-source: https://api.manychat.com/swagger/compileJson?type=Page_API
  x-harvested: '2026-08-13'
servers:
- url: https://api.manychat.com
  description: Production. ManyChat publishes servers[] as an empty relative URL; the host is the one serving the Swagger
    document.
security:
- Bearer: []
tags:
- name: Page
  description: 'Page-level configuration: connected page info, tags, custom fields, bot fields, flows and growth tools'
paths:
  /fb/page/getInfo:
    get:
      tags:
      - Page
      summary: Get info
      description: 'Rate limit: 100 queries per second'
      operationId: getPageInfo
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    $ref: '#/components/schemas/Page'
                type: object
      security:
      - Bearer: []
      x-provider-operation-id: b26c074b3783eb6e888c62324b17268c
  /fb/page/createTag:
    post:
      tags:
      - Page
      summary: Create tag
      description: 'Rate limit: 10 queries per second'
      operationId: createTag
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required:
              - name
              properties:
                name:
                  type: string
                  example: My tag
              type: object
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    required:
                    - tag
                    properties:
                      tag:
                        $ref: '#/components/schemas/Tag'
                    type: object
                    additionalProperties: false
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseError'
      security:
      - Bearer: []
      x-provider-operation-id: e964547412ede512f9534970c8e3971a
  /fb/page/getTags:
    get:
      tags:
      - Page
      summary: Get tags
      description: 'Rate limit: 100 queries per second'
      operationId: getTags
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Tag'
                type: object
      security:
      - Bearer: []
      x-provider-operation-id: 55f8b0c6040a20ba811a08eb4d92b9c2
  /fb/page/removeTag:
    post:
      tags:
      - Page
      summary: Remove tag
      description: 'Rate limit: 10 queries per second.

        Removes specified tag from the page and the page''s subscribers.

        This action can not be undone.'
      operationId: removeTag
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required:
              - tag_id
              properties:
                tag_id:
                  type: integer
                  example: 123
              type: object
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                    example: success
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseError'
      security:
      - Bearer: []
      x-provider-operation-id: 55b1d844eb0006f3c49e2a3ac524dd4e
  /fb/page/removeTagByName:
    post:
      tags:
      - Page
      summary: Remove tag by name
      description: 'Rate limit: 10 queries per second.

        Removes specified tag from the page and the page''s subscribers.

        This action can not be undone.'
      operationId: removeTagByName
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required:
              - tag_name
              properties:
                tag_name:
                  type: string
                  example: MyTagName
              type: object
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                    example: success
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseError'
      security:
      - Bearer: []
      x-provider-operation-id: 02235c5d38c1f33af18a296d331e5a35
  /fb/page/getWidgets:
    get:
      tags:
      - Page
      summary: Get widgets
      description: 'Rate limit: 100 queries per second.

        Use getGrowthTools instead.'
      operationId: getWidgets
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/GrowthTool'
                type: object
      deprecated: true
      security:
      - Bearer: []
      x-provider-operation-id: 33ec0bc6a34501ed9b4c2b6976b26bd2
  /fb/page/createCustomField:
    post:
      tags:
      - Page
      summary: Create custom field
      description: 'Rate limit: 10 queries per second'
      operationId: createCustomField
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required:
              - caption
              - type
              properties:
                caption:
                  type: string
                  example: My custom field name
                type:
                  description: 'Value from list: text, number, date, datetime, boolean'
                  type: string
                  example: text
                description:
                  type: string
                  example: This field store my custom field name
              type: object
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    required:
                    - field
                    properties:
                      field:
                        $ref: '#/components/schemas/CustomField'
                    type: object
                    additionalProperties: false
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseError'
      security:
      - Bearer: []
      x-provider-operation-id: 1d7171252e09f4e25b5123f9484ea3c1
  /fb/page/getGrowthTools:
    get:
      tags:
      - Page
      summary: Get growth tools
      description: 'Rate limit: 100 queries per second'
      operationId: getGrowthTools
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/GrowthTool'
                type: object
      security:
      - Bearer: []
      x-provider-operation-id: 2ab4a2a91a0b2cb1d5084e91b281e48c
  /fb/page/getFlows:
    get:
      tags:
      - Page
      summary: Get flows
      description: 'Rate limit: 10 queries per second'
      operationId: getFlows
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    required:
                    - flows
                    - folders
                    properties:
                      flows:
                        type: array
                        items:
                          $ref: '#/components/schemas/Flow'
                      folders:
                        type: array
                        items:
                          $ref: '#/components/schemas/Folder'
                    type: object
                    additionalProperties: false
                type: object
      security:
      - Bearer: []
      x-provider-operation-id: 6aee779784709b84bb0a734ebb42b650
  /fb/page/getCustomFields:
    get:
      tags:
      - Page
      summary: Get custom fields
      description: 'Rate limit: 100 queries per second'
      operationId: getCustomFields
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CustomField'
                type: object
      security:
      - Bearer: []
      x-provider-operation-id: 2bc43834222da265c4c41fbd129d1392
  /fb/page/getOtnTopics:
    get:
      tags:
      - Page
      summary: Get otn topics
      description: 'Rate limit: 100 queries per second'
      operationId: getOtnTopics
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/OtnTopic'
                type: object
      security:
      - Bearer: []
      x-provider-operation-id: b62d72c6502f4f7f687558c2f7a4c2c3
  /fb/page/getBotFields:
    get:
      tags:
      - Page
      summary: Get bot fields
      description: 'Rate limit: 100 queries per second'
      operationId: getBotFields
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/BotField'
                type: object
      security:
      - Bearer: []
      x-provider-operation-id: dbb46d786cc1323d56b27ff7de7bcc3f
  /fb/page/createBotField:
    post:
      tags:
      - Page
      summary: Create bot field
      description: 'Rate limit: 10 queries per second'
      operationId: createBotField
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required:
              - name
              - type
              properties:
                name:
                  type: string
                  example: My bot name
                type:
                  description: 'Value from list: text, number, date, datetime, boolean'
                  type: string
                  example: text
                description:
                  type: string
                  example: This field store my bot name
                value:
                  description: string, integer or boolean (see method description for setBotField)
                  example: '''string'', 123, true, ''2018-07-18'', ''2018-07-02T00:00:00+00:00'''
              type: object
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    required:
                    - field
                    properties:
                      field:
                        $ref: '#/components/schemas/BotField'
                    type: object
                    additionalProperties: false
                type: object
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseError'
      security:
      - Bearer: []
      x-provider-operation-id: 388714b65c83021aa8b1bb78481fb983
  /fb/page/setBotField:
    post:
      tags:
      - Page
      summary: Set bot field
      description: 'Rate limit: 10 queries per second'
      operationId: setBotField
      requestBody:
        description: 'Depending on the type of Bot Field you will need to use one of the following type of data for "field_value".

          ***For example:***

          Text: "text" (string)

          Number: 123 or 1.23 (integer or float)

          Boolean: true or false (boolean)

          Date: "2018-07-18" (string)

          Date and time: "2018-07-02T00:00:00+00:00" (string)


          Data and time format for this API method is YYYY-MM-DDTHH:MM:SSP.  Where P is user’s timezone. For example May 1st
          2018 06:30:24 UTC+3:00 should be formatted as 2018-05-01T06:30:24+03:00'
        required: true
        content:
          application/json:
            schema:
              required:
              - field_id
              - field_value
              properties:
                field_id:
                  type: integer
                field_value:
                  description: string, integer or boolean (see method description)
                  example: '''string'', 123, true, ''2018-07-18'', ''2018-07-02T00:00:00+00:00'''
              type: object
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseSuccess'
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseError'
      security:
      - Bearer: []
      x-provider-operation-id: 4032722e43e4b967e07d1b1279942254
  /fb/page/setBotFieldByName:
    post:
      tags:
      - Page
      summary: Set bot field by name
      description: 'Rate limit: 10 queries per second'
      operationId: setBotFieldByName
      requestBody:
        description: 'Depending on the type of Bot Field you will need to use one of the following type of data for "field_value".

          ***For example:***

          Text: "text" (string)

          Number: 123 or 1.23 (integer or float)

          Boolean: true or false (boolean)

          Date: "2018-07-18" (string)

          Date and time: "2018-07-02T00:00:00+00:00" (string)


          Data and time format for this API method is YYYY-MM-DDTHH:MM:SSP.  Where P is user’s timezone. For example May 1st
          2018 06:30:24 UTC+3:00 should be formatted as 2018-05-01T06:30:24+03:00'
        required: true
        content:
          application/json:
            schema:
              required:
              - field_name
              - field_value
              properties:
                field_name:
                  type: string
                field_value:
                  description: string, integer or boolean (see method description)
                  example: '''string'', 123, true, ''2018-07-18'', ''2018-07-02T00:00:00+00:00'''
              type: object
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseSuccess'
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseError'
      security:
      - Bearer: []
      x-provider-operation-id: 63284ce7970087a42458d5a2c2594c1b
  /fb/page/setBotFields:
    post:
      tags:
      - Page
      summary: Set bot fields
      description: 'Rate limit: 10 queries per second'
      operationId: setBotFields
      requestBody:
        description: 'Set multiple bot fields.

          The number of bot fields is limited to 20 for one request.

          Use **field_id** OR **field_name** to specify the field.

          ***For example:***


          ```"fields": [{"field_id": 77777777, "field_value": 555}, {"field_name": "count", "field_value": 12}]```'
        required: true
        content:
          application/json:
            schema:
              required:
              - fields
              properties:
                fields:
                  type: array
                  items:
                    required:
                    - field_id
                    - field_name
                    - field_value
                    properties:
                      field_id:
                        type: integer
                      field_name:
                        type: string
                      field_value:
                        description: string, integer or boolean (see method description)
                        example: '''string'', 123, true, ''2018-07-18'', ''2018-07-02T00:00:00+00:00'''
                    type: object
                    additionalProperties: false
              type: object
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseSuccess'
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseError'
      security:
      - Bearer: []
      x-provider-operation-id: 327327a53f87fecaeb9f7cd69c0433af
components:
  schemas:
    BotField:
      description: ''
      required:
      - id
      - name
      - type
      - description
      - value
      properties:
        id:
          type: integer
        name:
          type: string
        type:
          type: string
          enum:
          - text
          - number
          - date
          - datetime
          - boolean
        description:
          type: string
        value:
          description: string, integer or boolean
          example: '''string'', 123, true, ''2018-07-18'', ''2018-07-02T07:45:00+03:00'''
      type: object
      additionalProperties: false
    CustomField:
      description: ''
      required:
      - id
      - name
      - type
      - description
      properties:
        id:
          type: integer
        name:
          type: string
        type:
          type: string
          enum:
          - text
          - number
          - date
          - datetime
          - boolean
        description:
          type: string
      type: object
      additionalProperties: false
    Flow:
      description: ''
      required:
      - ns
      - name
      - folder_id
      properties:
        ns:
          description: Automation namespace - unique Automation ID
          type: string
        name:
          type: string
        folder_id:
          type: integer
      type: object
      additionalProperties: false
    Folder:
      description: ''
      required:
      - id
      - name
      - parent_id
      properties:
        id:
          type: integer
        name:
          type: string
        parent_id:
          type: integer
      type: object
      additionalProperties: false
    GrowthTool:
      description: ''
      required:
      - id
      - name
      - type
      properties:
        id:
          type: integer
        name:
          type: string
        type:
          type: string
      type: object
      additionalProperties: false
    OtnTopic:
      description: ''
      required:
      - id
      - name
      - description
      properties:
        id:
          type: integer
        name:
          type: string
        description:
          type: string
      type: object
      additionalProperties: false
    Page:
      description: ''
      required:
      - id
      - name
      - category
      - avatar_link
      - username
      - about
      - description
      - is_pro
      - timezone
      properties:
        id:
          description: This is Facebook Page ID
          type: integer
        name:
          type: string
        category:
          type: string
        avatar_link:
          type: string
        username:
          type: string
        about:
          type: string
        description:
          type: string
        is_pro:
          type: boolean
        timezone:
          type: string
      type: object
      additionalProperties: false
    ResponseError:
      description: ''
      required:
      - status
      - message
      - details
      properties:
        status:
          type: string
          example: error
        message:
          type: string
        details:
          required:
          - messages
          properties:
            messages:
              type: array
              items:
                $ref: '#/components/schemas/ResponseErrorMessage'
          type: object
          additionalProperties: false
      type: object
      additionalProperties: false
    ResponseErrorMessage:
      description: ''
      required:
      - message
      properties:
        message:
          type: string
      type: object
      additionalProperties: false
    ResponseSuccess:
      description: ''
      required:
      - status
      properties:
        status:
          type: string
          example: success
      type: object
      additionalProperties: false
    Tag:
      description: ''
      required:
      - id
      - name
      properties:
        id:
          type: integer
        name:
          type: string
      type: object
      additionalProperties: false
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      description: 'API key generated per page in the ManyChat dashboard under Settings > API. Sent as `Authorization: Bearer
        <page-id>:<api-key>`.'