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

# Send Events Using the API

> The Conversions API is based on Facebook's [Marketing API](https://developers.facebook.com/docs/marketing-apis), which was built on top of our [Graph API](https://developers.facebook.com/docs/graph-api).

<Note>
  **Note:**

  Web and app events shared using the Conversions API require specific parameters. By using the Conversions API, you agree that the action\_source parameter is accurate to the best of your knowledge. For more information about parameters to use, refer [here](https://docs.zeotap.com/articles/project-integrate/appendix/a/h2__49116610).
</Note>

### Send Requests

To send new events, make a POST request to this API's /events edge from this path: `https://graph.facebook.com/{API_VERSION}/{PIXEL_ID}/events?access_token={TOKEN}`. When you post to this edge, Facebook creates new server events.

```json Code expandable theme={null}
curl -X POST \
  -F 'data=[
    {
      "event_name": "Purchase",
      "event_time": 1697131000,
      "user_data": {
        "em": [
          "309a0a5c3e211326ae75ca18196d301a9bdbd1a882a4d2569511033da23f0abd"
        ],
        "ph": [
          "254aa248acb47dd654ca3ea53f48c2c26d641d23d7e2e93a1ec56258df7674c4",
          "6f4fcb9deaeadc8f9746ae76d97ce1239e98b404efe5da3ee0b7149740f89ad6"
        ],
        "client_ip_address": "123.123.123.123",
        "client_user_agent": "$CLIENT_USER_AGENT",
        "fbc": "fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890",
        "fbp": "fb.1.1558571054389.1098115397"
      },
      "custom_data": {
        "currency": "usd",
        "value": 123.45,
        "contents": [
          {
            "id": "product123",
            "quantity": 1,
            "delivery_category": "home_delivery"
          }
        ]
      },
      "event_source_url": "http://jaspers-market.com/product/123",
      "action_source": "website"
    }
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v18.0/<PIXEL_ID>/events
```

Attach your generated secure access token using the `access_token `query parameter to the request. You can also use [Graph API Explorer](https://developers.facebook.com/tools/explorer/?method=POST\&path=%7BPIXEL_ID%7D%2Fevents%2F\&version=v3.2) to POST to the `/<pixel_id>/events` endpoint.

An example request body looks like this:

```json Code expandable theme={null}
{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1633552688,
      "event_id": "event.id.123",
      "event_source_url": "http://jaspers-market.com/product/123",
      "action_source": "website",
      "user_data": {
        "client_ip_address": "192.19.9.9",
        "client_user_agent": "test ua",
        "em": [
          "309a0a5c3e211326ae75ca18196d301a9bdbd1a882a4d2569511033da23f0abd"
        ],
        "ph": [
          "254aa248acb47dd654ca3ea53f48c2c26d641d23d7e2e93a1ec56258df7674c4",
          "6f4fcb9deaeadc8f9746ae76d97ce1239e98b404efe5da3ee0b7149740f89ad6"
        ],
        "fbc": "fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890",
        "fbp": "fb.1.1558571054389.1098115397"
      },
      "custom_data": {
        "value": 100.2,
        "currency": "USD",
        "content_ids": [
          "product.id.123"
        ],
        "content_type": "product"
      },
      "opt_out": false
    },
    {
      "event_name": "Purchase",
      "event_time": 1633552688,
      "user_data": {
        "client_ip_address": "192.88.9.9",
        "client_user_agent": "test ua2"
      },
      "custom_data": {
        "value": 50.5,
        "currency": "USD"
      },
      "opt_out": true
    }
  ]
}
```