Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.partnero.com/llms.txt

Use this file to discover all available pages before exploring further.

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

  1. Create an incoming webhook in Partnero
  2. Send sample data to the Test URL
  3. Map the incoming fields to Partnero fields
  4. Use the Production URL to send live data

​
Creating an Incoming Webhook

1

Go to Incoming Webhooks

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

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.
3

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
  }'
4

Select an action

Choose what you want to do with the incoming data:
  • Create a partner (Affiliate programs)
  • Create a customer
  • Create a transaction
5

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
6

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.
FieldRequiredDescription
Email addressYesPartner’s email
NameYesPartner’s name
Partner IDNoCustom identifier
Partner keyNoCustom referral key
Referring partner keyNoFor multi-tier programs

​
Create a Customer

Creates a new customer linked to a partner.
FieldRequiredDescription
Email addressYesCustomer’s email
NameYesCustomer’s name
Customer keyNoCustom identifier
Partner key/ID/emailNoLinks 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.
FieldRequiredDescription
AmountYesTransaction amount
Customer keyYesWhich customer made the purchase
Transaction keyNoUnique identifier (recommended)
Product IDNoProduct identifier
Product typeNoe.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 PathPartnero Field
customer.emailEmail address
customer.nameName
order.idTransaction key
order.amountAmount
order.productProduct ID
referral_codePartner 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.