# Create pixel

This route allows you to create a tracking pixel linked to your account, with support for Google and Meta platforms. After creation, the pixel must be integrated into your website or application using our official SDK to ensure proper event sending and tracking.

👉 Access the SDK and usage instructions: SDK

Endpoint: POST /pixels
Version: 1.0

## Header parameters:

  - `x-api-key` (string, required)
    Api key provided on integrations tab in Easyflow platform.

  - `x-api-secret` (string, required)
    Api Secret provided on integrations tab in Easyflow platform.

## Request fields (application/json):

  - `name` (string, required)

  - `description` (string)

  - `ownerId` (string, required)

  - `externalReferenceId` (string, required)

  - `platform` (string, required)
    available platforms:  and

  - `code` (string)

  - `events` (array, required)
    An array of event types that the pixel should track. Each item must be one of the predefined event identifiers listed below:

- checkout-initialized

- purchase-completed

- purchase-failed

- purchase-btn-clicked

- pix-selected

- pix-generated

- pix-expired

- pix-copied

- credit-card-selected

- credit-card-form-completed

- bank-slip-selected

- bank-slip-form-completed

- address-form-completed

- delivery-address-completed

- coupon-added

- coupon-box-clicked

- coupon-form-completed

- coupon-apply-failed

- user-form-completed

  - `metadata` (object)

  - `metadata.conversion-label` (string)
    required field if it is the google pixel

## Response 200 fields (application/json):

  - `statusCode` (integer)

  - `data` (object)

  - `data.pixel` (object)

  - `data.pixel.events` (array)

  - `data.pixel.id` (string)

  - `data.pixel.createdAt` (string)

  - `data.pixel.updatedAt` (string)

  - `data.pixel.ownerId` (string)

  - `data.pixel.externalReferenceId` (string)

  - `data.pixel.platform` (string)

  - `data.pixel.status` (string)

  - `data.pixel.code` (string)

  - `data.pixel.name` (string)

  - `data.pixel.description` (string)

  - `data.pixel.metadata` (object)

  - `data.pixel.metadata.conversion-label` (string)

## Response 400 fields (application/json):

  - `message` (string)
    Invalid param: []
    Example: "Invalid param: []"

  - `error` (string)
    Bad Request
    Example: "Bad Request"

  - `statusCode` (integer)
    400
    Example: 400

## Response 401 fields (application/json):

  - `message` (string)
    Invalid field
    Example: "Unauthorized"

  - `error` (string)
    Unauthorized
    Example: "Unauthorized"

  - `statusCode` (integer)
    401
    Example: 401

## Response 403 fields (application/json):

  - `message` (string)
    Forbidden resource
    Example: "Forbidden resource"

  - `error` (string)
    Forbidden
    Example: "Forbidden"

  - `statusCode` (integer)
    403
    Example: 403

## Response 500 fields (application/json):

  - `message` (string)
    Internal server error
    Example: "Internal server error"

  - `error` (string)
    Internal Server Error
    Example: "Internal Server Error"

  - `statusCode` (integer)
    500
    Example: 500