---
updatedAt: 2025-02-14T21:01:43.000Z
agentTools:
  projectIndex: https://developer.getontop.com/llms.txt
---

# Create configuration

```
curl --location 'https://api.demo.getontop.com/webhooks/clients' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxxxxxxxxxx' \
--data '{
    "url": "http://localhost/events",
 "headers": [{
"name": "X-CUSTOM-HEADER-1",
"value": "CUSTOM-VALUE"
 }],
    "event_types": [
        "KYC", "CLIENT_WALLET_TOP_UP", "PAYMENT",
    ]
}'

```

```
{
  "client_id": 999,
  "url": "https://api.demo.getontop.com/webhooks/events",
  "enabled": true,
  "headers": [{
  "name": "X-CUSTOM-HEADER-1",
  "value": "CUSTOM-VALUE"
}],
"event_types": [
  "KYC",
  "CLIENT_WALLET_TOP_UP",
  "PAYMENT"
],
  "created_at": "2023-10-25T14:41:14.574712103Z",
  "updated_at": "2023-10-25T14:41:14.574713670Z"
}

```

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "ONTOP API",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.demo.getontop.com"
    }
  ],
  "tags": [
    {
      "name": "Webhooks"
    }
  ],
  "paths": {
    "/webhooks/clients": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "summary": "Updating configuration",
        "requestBody": {
          "content": {
            "*/*": {
              "schema": {
                "type": "string",
                "example": "\"{\\n    \\\"event_types\\\": [\\n        \\\"KYC\\\"    \\n]\\n}\""
              }
            }
          }
        },
        "parameters": [
          {
            "name": "Content-Type",
            "in": "header",
            "schema": {
              "type": "string"
            },
            "example": "application/json"
          },
          {
            "name": "Authorization",
            "in": "header",
            "schema": {
              "type": "string"
            },
            "example": "Bearer xxxxxxxxxxxxxxxxxx"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```