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

# Send Funnel Event



## OpenAPI

````yaml /actionkit/openapi.json POST /projects/{project_id}/tools/#FACEBOOK_ADS_SEND_FUNNEL_EVENT
openapi: 3.0.0
info:
  title: ActionKit Tools API
  version: 1.0.0
servers:
  - url: https://actionkit.useparagon.com
    description: US Cloud
security: []
paths:
  /projects/{project_id}/tools/#FACEBOOK_ADS_SEND_FUNNEL_EVENT:
    post:
      summary: Send Funnel Event
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              Your Paragon Project ID. You can copy your Project ID from your
              dashboard URL or by clicking Copy Project ID under the Environment
              switcher.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tool:
                  type: string
                  default: FACEBOOK_ADS_SEND_FUNNEL_EVENT
                parameters:
                  type: object
                  properties:
                    eventName:
                      type: string
                      description: Event Name
                    actionSource:
                      type: string
                      description: Action Source
                      enum:
                        - website
                        - chat
                        - app
                        - email
                        - phone_call
                        - system_generated
                        - other
                    pixel:
                      type: string
                      description: The Facebook Pixel that will receive the event
                    eventTime:
                      type: string
                      description: >-
                        Event Time : Time when the event occurred (ISO 8601
                        timestamp). Defaults to the time of the workflow
                        execution if left blank (example:
                        "2020-03-31T12:02:00Z")
                    eventId:
                      type: string
                      description: >-
                        Event ID : Used to remove duplicates when sending the
                        same event from more than one source.
                    eventSourceUrl:
                      type: string
                      description: >-
                        Event Source URL : The URL where the event occurred.
                        Required if the Action Source is Website.
                    customerEmail:
                      type: string
                      description: >-
                        Customer Email : The email of the customer associated
                        with the event, so they can be matched to a Facebook
                        account and used for ads attribution and delivery
                        optimization.
                    customerFirstName:
                      type: string
                      description: Customer first name
                    customerLastName:
                      type: string
                      description: Customer last name
                    customerCity:
                      type: string
                      description: Customer city
                    customerState:
                      type: string
                      description: Customer state
                    customerCountryCode:
                      type: string
                      description: Customer country code
                    customerExternalId:
                      type: string
                      description: >-
                        Customer External ID : A custom ID for the prospect,
                        often referencing an ID in an external system.
                    customerClientIpAddress:
                      type: string
                      description: >-
                        Customer client IP address : The IP address of the
                        browser corresponding to the event.
                    customerClientUserAgent:
                      type: string
                      description: >-
                        Customer client user agent : The user agent for the
                        browser corresponding to the event.
                    clickId:
                      type: string
                      description: >-
                        Click ID (fbc) : The Facebook click ID value stored in
                        the _fbc browser cookie.
                    browserId:
                      type: string
                      description: >-
                        Browser ID (fbc) : The Facebook browser ID value stored
                        in the _fbp browser cookie.
                    contentId:
                      type: string
                      description: >-
                        Content ID : The content IDs associated with the event,
                        such as product SKUs for items in an AddToCart event.
                        Accepts an array of IDs. (example: "['ABC123',
                        'XYZ789']")
                    contentName:
                      type: string
                      description: >-
                        Content Name : The name of the page or product
                        associated with the event. (example: "Lettuce")
                    contentCategory:
                      type: string
                      description: >-
                        Content Category : The category of the content
                        associated with the event. (example: "Grocery")
                  required:
                    - eventName
                    - actionSource
                    - pixel
                  x-integration: facebookAds
              required:
                - tool
                - parameters
      responses:
        '200':
          description: Success
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Your [Paragon User
        Token](/getting-started/installing-the-connect-sdk#setup) (JWT), which
        you can generate using your project's signing keys.

````