> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useinvent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Meta agent connector tool

> Fetch one tool.



## OpenAPI

````yaml https://api.useinvent.com/openapi.json get /orgs/{org_id}/connections/{connection_id}/whatsapp/phone-numbers/{phone_number_id}/meta-agent/connectors/{connector_id}/tools/{tool_id}
openapi: 3.1.0
info:
  version: 1.0.0
  title: Invent API
servers:
  - url: https://api.useinvent.com
security:
  - bearerAuth: []
tags:
  - name: Inbox
  - name: Chats
  - name: Messages
  - name: Contacts
  - name: Custom channels
  - name: Segments
  - name: Suppressions
  - name: Assistants
  - name: Agents
  - name: Skills
  - name: Knowledge
  - name: AI
  - name: Broadcasts
  - name: Email sending
  - name: WhatsApp
  - name: WhatsApp Meta agent
  - name: Tables
  - name: Records
  - name: Views
  - name: Pages
  - name: Connections
  - name: Workspace
  - name: Sub-organizations
  - name: Analytics and logs
  - name: Workflows
paths:
  /orgs/{org_id}/connections/{connection_id}/whatsapp/phone-numbers/{phone_number_id}/meta-agent/connectors/{connector_id}/tools/{tool_id}:
    get:
      tags:
        - WhatsApp Meta agent
      summary: Get Meta agent connector tool
      description: Fetch one tool.
      parameters:
        - schema:
            type: string
          required: true
          description: The ID of the org
          name: org_id
          in: path
        - schema:
            type: string
          required: true
          description: The ID of the connection
          name: connection_id
          in: path
        - schema:
            type: string
          required: true
          description: The ID of the WhatsApp phone number the Meta agent runs on
          name: phone_number_id
          in: path
        - schema:
            type: string
          required: true
          description: The ID of the connector
          name: connector_id
          in: path
        - schema:
            type: string
          required: true
          description: The ID of the connector tool
          name: tool_id
          in: path
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WhatsAppMetaAgentToolSchema'
components:
  schemas:
    WhatsAppMetaAgentToolSchema:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
        request_definition:
          $ref: '#/components/schemas/WhatsAppMetaAgentToolRequestSchema'
        user_auth_required:
          type: boolean
        user_auth_action_config:
          $ref: '#/components/schemas/WhatsAppMetaAgentToolUserAuthActionSchema'
        transformation_spec:
          $ref: '#/components/schemas/WhatsAppMetaAgentToolTransformationSchema'
      required:
        - id
        - name
    WhatsAppMetaAgentToolRequestSchema:
      type: object
      properties:
        method:
          type: string
          enum:
            - GET
            - POST
            - PUT
            - DELETE
            - PATCH
        path:
          type: string
          minLength: 1
          maxLength: 2048
          description: Path on the connector base URL, with {placeholders}.
          example: /orders/{order_id}
        path_parameters:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/WhatsAppMetaAgentToolParameterSchema'
        query_parameters:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/WhatsAppMetaAgentToolParameterSchema'
        headers:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/WhatsAppMetaAgentToolParameterSchema'
        body:
          type: object
          properties:
            content_type:
              type: string
              enum:
                - application/json
            params:
              type: object
              additionalProperties:
                $ref: '#/components/schemas/WhatsAppMetaAgentToolBodyFieldSchema'
            required:
              type: array
              items:
                type: string
                maxLength: 256
              maxItems: 100
          required:
            - content_type
            - params
      required:
        - method
        - path
    WhatsAppMetaAgentToolUserAuthActionSchema:
      type: object
      properties:
        user_action_tool_type:
          type: string
          enum:
            - auth
            - refresh
        user_auth_token_path:
          type: string
          maxLength: 512
        refresh_token_path:
          type: string
          maxLength: 512
        expires_at_path:
          type: string
          maxLength: 512
        expires_at_type:
          type: string
          enum:
            - absolute
            - relative_seconds
      required:
        - user_action_tool_type
        - user_auth_token_path
      description: >-
        Marks a tool that signs the customer in: where Meta reads the customer's
        token in the response.
    WhatsAppMetaAgentToolTransformationSchema:
      type: object
      properties:
        version:
          type: number
          enum:
            - 1
        steps:
          type: array
          items:
            type: object
            properties:
              kind:
                type: string
                enum:
                  - allowlist
                  - case
                  - catalog
                  - decorate_url
                  - dedupe
                  - dehydrate
                  - filter
                  - first_nonempty
                  - first_nonnull
                  - first_nonzero
                  - format
                  - html_escape
                  - lookup
                  - math
                  - proxy_image
                  - reshape
                  - shadow_allowlist
                  - string_replace
                  - truncate
              target:
                type: string
                maxLength: 512
              params:
                type: string
                maxLength: 100000
                description: The step settings as a JSON string.
            required:
              - kind
          maxItems: 5
      required:
        - version
        - steps
      description: Up to 5 steps that trim the response before the agent reads it.
    WhatsAppMetaAgentToolParameterSchema:
      type: object
      properties:
        type:
          type: string
          enum:
            - string
            - integer
            - number
            - boolean
        description:
          type: string
          maxLength: 1024
        required:
          type: boolean
        binding:
          $ref: '#/components/schemas/WhatsAppMetaAgentToolBindingSchema'
      required:
        - type
    WhatsAppMetaAgentToolBodyFieldSchema:
      type: object
      properties:
        type:
          type: string
          enum:
            - object
            - array
            - string
            - integer
            - number
            - boolean
        description:
          type: string
          maxLength: 1024
        required:
          type: array
          items:
            type: string
            maxLength: 256
          maxItems: 100
        properties:
          type: string
          maxLength: 100000
          description: Nested fields of an object, as a JSON string of this same shape.
        items:
          type: string
          maxLength: 100000
          description: The item shape of an array, as a JSON string of this same shape.
        binding:
          $ref: '#/components/schemas/WhatsAppMetaAgentToolBindingSchema'
      required:
        - type
    WhatsAppMetaAgentToolBindingSchema:
      oneOf:
        - type: object
          properties:
            kind:
              type: string
              enum:
                - default
            value:
              type: string
              maxLength: 4096
          required:
            - kind
            - value
        - type: object
          properties:
            kind:
              type: string
              enum:
                - macro
            macro:
              $ref: '#/components/schemas/WhatsAppMetaAgentToolMacroSchema'
          required:
            - kind
            - macro
      description: >-
        Fills the parameter instead of the agent: a fixed value, or a value from
        the conversation.
    WhatsAppMetaAgentToolMacroSchema:
      type: string
      enum:
        - WHATSAPP_PHONE_NUMBER
        - WHATSAPP_PHONE_NUMBER_NATIONAL
        - WHATSAPP_IDENTITY_HASH
        - WHATSAPP_CURRENT_STATUS_ID
        - WHATSAPP_BSUID
        - USER_MESSAGE
        - WHATSAPP_CONVERSATION_ID
        - WHATSAPP_MESSAGE_ID
      description: A value Meta fills in from the conversation.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: Bearer token authentication using your API key

````