Skip to main content
POST
/
v1
/
webhooks
Create webhook
curl --request POST \
  --url https://api.example.com/v1/webhooks
{
  "data": {
    "key": "uLbBzVvN7ARX",
    "name": "Partner Notifications",
    "url": "https://yourcompany.com/webhooks/partnero",
    "is_active": true,
    "signature": "Sjn3sNnmh14yk6zb",
    "events": [
      "partner.created",
      "partner.approved",
      "transaction.created"
    ]
  },
  "status": 1
}

​
Endpoint

POST https://api.partnero.com/v1/webhooks

​
Request Body

ParameterTypeRequiredDescription
namestringYesName for the webhook
urlstringYesURL where webhook events will be sent
eventsarrayYesArray of event types to subscribe to
keystringNoCustom unique ID (auto-generated if not provided)
is_activebooleanNoWhether the webhook is active (default: true)

​
Request

cURL
curl --location 'https://api.partnero.com/v1/webhooks' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Partner Notifications",
    "url": "https://yourcompany.com/webhooks/partnero",
    "events": [
      "partner.created",
      "partner.approved",
      "transaction.created"
    ]
  }'

​
Response

{
  "data": {
    "key": "uLbBzVvN7ARX",
    "name": "Partner Notifications",
    "url": "https://yourcompany.com/webhooks/partnero",
    "is_active": true,
    "signature": "Sjn3sNnmh14yk6zb",
    "events": [
      "partner.created",
      "partner.approved",
      "transaction.created"
    ]
  },
  "status": 1
}
Store the signature value securely. You’ll need it to verify incoming webhook requests.