Incoming webhooks

Incoming webhooks let external apps send data into your Partnero account. Use them to automatically create partners, customers, or transactions when events occur in your other systems.

How It Works

Create an incoming webhook in Partnero
Send sample data to the Test URL
Map the incoming fields to Partnero fields
Use the Production URL to send live data

Creating an Incoming Webhook

Go to Incoming Webhooks

Navigate to Program Settings → Incoming Webhooks and click Create an incoming webhook.

Copy your URLs

You’ll receive two URLs:

Test URL - Send sample data here first. No data is created in your account.
Production URL - Send real data here once mapping is configured.

Send test data

Send a sample JSON payload to your Test URL:

curl -X POST 'YOUR_TEST_URL' \
  -H 'Content-Type: application/json' \
  -d '{
    "user_email": "[email protected]",
    "user_name": "John Doe",
    "order_id": "12345",
    "total": 99.99
  }'

Select an action

Choose what you want to do with the incoming data:

Create a partner (Affiliate programs)
Create a customer
Create a transaction

Map the fields

Partnero parses your sample data and shows all available field paths. Map them to the required fields:

Your Data	→	Partnero Field
`user_email`	→	Email address
`user_name`	→	Name
`order_id`	→	Transaction key
`total`	→	Amount

Save and go live

Save your webhook configuration. Start sending real data to your Production URL.

Available Actions

Create a Partner

Available for Affiliate programs. Creates a new partner in your program.

Field	Required	Description
Email address	Yes	Partner’s email
Name	Yes	Partner’s name
Partner ID	No	Custom identifier
Partner key	No	Custom referral key
Referring partner key	No	For multi-tier programs

Create a Customer

Creates a new customer linked to a partner.

Field	Required	Description
Email address	Yes	Customer’s email
Name	Yes	Customer’s name
Customer key	No	Custom identifier
Partner key/ID/email	No	Links customer to partner

For Refer-a-Friend programs, you can also specify:

Referring customer key/email/ID

Create a Transaction

Records a sale or purchase.

Field	Required	Description
Amount	Yes	Transaction amount
Customer key	Yes	Which customer made the purchase
Transaction key	No	Unique identifier (recommended)
Product ID	No	Product identifier
Product type	No	e.g., `monthly`, `yearly`

Example: Complete Flow

1. Your external app sends order data:

{
  "event": "order_completed",
  "customer": {
    "email": "[email protected]",
    "name": "Jane Smith"
  },
  "order": {
    "id": "ORD-789",
    "amount": 149.99,
    "product": "pro_plan"
  },
  "referral_code": "PARTNER123"
}

2. Map the fields in Partnero:

Incoming Path	Partnero Field
`customer.email`	Email address
`customer.name`	Name
`order.id`	Transaction key
`order.amount`	Amount
`order.product`	Product ID
`referral_code`	Partner key

3. Partnero automatically:

Finds or creates the customer
Links them to the partner with key PARTNER123
Creates the transaction
Calculates commission

Tips

Always include a unique transaction key to prevent duplicates and enable refund tracking.

Field mapping is flexible—Partnero can extract values from nested JSON objects like customer.email or order.details.total.

Test URL requests don’t create any data. Always verify your mapping works with test data before switching to the Production URL.

Getting started

Programs

Tracking integration

No-code solutions

Postbacks

Webhooks

AI & MCP

Incoming webhooks

How It Works

Creating an Incoming Webhook

Available Actions

Create a Partner

Create a Customer

Create a Transaction

Example: Complete Flow

Tips

​How It Works

​Creating an Incoming Webhook

​Available Actions

​Create a Partner

​Create a Customer

​Create a Transaction

​Example: Complete Flow

​Tips

How It Works

Creating an Incoming Webhook

Available Actions

Create a Partner

Create a Customer

Create a Transaction

Example: Complete Flow

Tips