Skip to content
/
New Influencer Referral

Influencer Hero API (1.4.2)

API documentation for the Influencer Hero platform.

Download OpenAPI description
ih_api.json
ih_api.yaml
Overview
URL
https://help.influencer-hero.com/
Influencer Hero Support
support@influencer-hero.com
Languages
Servers
https://api.influencer-hero.com/

Test endpoints

Endpoints to test authenticated and public requests

Operations

Search & Reports

Operations

Identify influencers

Operations

Helper endpoints

Operations

Import influencers

Operations

Influencer Page

Operations

Affiliate Tracking

[Advanced] Server-side endpoints for tracking affiliate actions and performance. For most use cases, the client-side tracking script will be sufficient.

Operations

New Influencer Click

Request

Increases the number of tracked clicks on an influencer's deal page.

Security
ApiKeyAuth
Bodyapplication/jsonrequired
influencer_handlestring

Influencer handle. Either deal_id, influencer_handle, or collab_id is required.

Example: "therock"
deal_idstring

Deal ID or URL. Either deal_id, influencer_handle, or collab_id is required.

Example: "ETUNQ6ZTW1"
collab_idstring

Collaboration ID. Either deal_id, influencer_handle, or collab_id is required.

Example: "V2KYU6F9"
brand_idinteger

Brand ID (optional, used to find the correct collaboration if multiple exist).

Example: 4819
increase_clicksintegerrequired

Number of clicks to add. Defaults to 0.

Example: 10
country_codestring

Country code for click origin.

Example: "US"
curl -i -X POST \
  https://api.influencer-hero.com/v1/crm/new_influencer_click \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "influencer_handle": "therock",
    "deal_id": "ETUNQ6ZTW1",
    "collab_id": "V2KYU6F9",
    "brand_id": 4819,
    "increase_clicks": 10,
    "country_code": "US"
  }'

Responses

Clicks successfully added.

Bodyapplication/json
Response
application/json
{
  "deal_id": "ETUNQ6ZTW1",
  "collab_id": "V2KYU6F9",
  "new_clicks_value": 150,
  "message": "Clicks successfully added."
}

New Influencer Referral

Request

Adds a new order/referral to an influencer's affiliate performance.

Security
ApiKeyAuth
Bodyapplication/jsonrequired
influencer_handlestring

Influencer handle. Either deal_id, influencer_handle, or collab_id is required.

Example: "therock"
deal_idstring

Deal ID or URL. Either deal_id, influencer_handle, or collab_id is required.

Example: "ETUNQ6ZTW1"
collab_idstring

Collaboration ID. Either deal_id, influencer_handle, or collab_id is required.

Example: "V2KYU6F9"
brand_idinteger

Brand ID (optional, used to find the correct collaboration if multiple exist).

Example: 4819
order_idstring

Order ID. Recommended to include for tracking purposes.

Example: "891237123"
order_revenuenumber

Revenue of the order.

Example: 150.5
order_platformstring

Platform of the order.

Example: "shopify"
order_discount_codes_usedstring

Discount codes used.

Example: "DISCOUNT50"
order_notesstring

Notes about the order.

Example: "High-value customer."
currencystring

Currency code for the order (e.g., USD, EUR). Defaults to account currency.

Example: "USD"
curl -i -X POST \
  https://api.influencer-hero.com/v1/crm/new_influencer_referral \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "influencer_handle": "therock",
    "deal_id": "ETUNQ6ZTW1",
    "collab_id": "V2KYU6F9",
    "brand_id": 4819,
    "order_id": "891237123",
    "order_revenue": 150.5,
    "order_platform": "shopify",
    "order_discount_codes_used": "DISCOUNT50",
    "order_notes": "High-value customer.",
    "currency": "USD"
  }'

Responses

Order successfully added.

Bodyapplication/json
Response
application/json
{
  "deal_id": "ETUNQ6ZTW1",
  "collab_id": "V2KYU6F9",
  "message": "Order successfully added."
}

Managing Webhooks

Operations

Webhooks

Receive real-time notifications when events occur in your account. Webhooks are secured via HMAC-SHA256 signatures.

Webhooks