Skip to content
/
Update Custom Link

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

Managing Webhooks

Operations

Webhooks

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

Webhooks

Update Discount CodeWebhook

Request

This webhook is triggered when a discount code is updated for a collaboration. The receiving endpoint can use X-InfluencerHero-Timestamp and X-InfluencerHero-Signature to verify authenticity via HMAC-SHA256.

Security
ApiKeyAuth
Headers
X-InfluencerHero-Timestampstringrequired

Unix timestamp (in seconds) at which the webhook was sent.

X-InfluencerHero-Signaturestringrequired

HMAC-SHA256 signature computed using your webhook signing key and the request body.

Bodyapplication/jsonrequired

Payload containing information about the updated discount code.

webhook_timestampstringrequired

Server-side timestamp included in the webhook body.

code_informationobjectrequired

Details about the previous and new discount codes.

code_information.​old_discount_codestring

The existing discount code before the update.

code_information.​old_discount_percnumber

The existing discount percentage before the update.

code_information.​new_discount_codestring

The new discount code, if changed.

code_information.​new_discount_percnumber

The new discount percentage, if changed.

collab_idstringrequired

Unique identifier of the collaboration receiving the discount code.

deal_infoobject(DealInfo)

A lightweight summary of the influencers deal.

deal_idstringrequired

Unique identifier of the deal associated with this discount code.

application/json
{
  "webhook_timestamp": "1693427202",
  "code_information": {
    "old_discount_code": "FIT2023",
    "old_discount_perc": 15,
    "new_discount_code": "FIT2024",
    "new_discount_perc": 20
  },
  "collab_id": "collab987",
  "deal_info": {
    "deal_name": "therock",
    "is_active": true,
    "dealflow_funnel_step": 3,
    "dealflow_type": "outreach",
    "dealflow_name": "Spring Collection Promo",
    "picture_url": "https://imgp.sptds.icu/v2?mb0KwpL92uYofJiSjDn1%2F6peL1lBwv3s%2BUvShHERlDbrEEwrWumIvR20xZeZXa0LDeIrcniqZeG9S%2F1a5s2Rx3FZdXrWpY%2BmSBJp1l%2FmBGon3rcHA4EfuatZqMhVBzAT",
    "nr_followers": 60000,
    "full_name": "Dwayne Johnson",
    "platform": "instagram",
    "profile_url": "https://instagram.com/therock"
  },
  "deal_id": "xyz789"
}

Responses

The server processing the webhook should generally return a 200 status indicating successful receipt.

Update CommissionWebhook

Request

This webhook is triggered when a commission percentage is updated for a collaboration. The receiving endpoint can use X-InfluencerHero-Timestamp and X-InfluencerHero-Signature to verify authenticity via HMAC-SHA256.

Security
ApiKeyAuth
Headers
X-InfluencerHero-Timestampstringrequired

Unix timestamp (in seconds) at which the webhook was sent.

X-InfluencerHero-Signaturestringrequired

HMAC-SHA256 signature computed using your webhook signing key and the request body.

Bodyapplication/jsonrequired

Payload containing information about the updated commission percentage.

webhook_timestampstringrequired

Server-side timestamp included in the webhook body.

commission_informationobjectrequired

Details about the previous and new commission percentages.

commission_information.​old_commission_percnumber or null

The existing commission percentage before the update.

commission_information.​new_commission_percnumber

The new commission percentage.

collab_idstringrequired

Unique identifier of the collaboration.

deal_idstringrequired

Unique identifier of the deal associated with this collaboration.

deal_infoobject(DealInfo)

A lightweight summary of the influencers deal.

is_ch_collabboolean

Whether this is a Creator Hero collaboration.

application/json
{
  "webhook_timestamp": "1693427202",
  "commission_information": {
    "old_commission_perc": 10,
    "new_commission_perc": 15
  },
  "collab_id": "collab987",
  "deal_id": "xyz789",
  "deal_info": {
    "deal_name": "therock",
    "is_active": true,
    "dealflow_funnel_step": 3,
    "dealflow_type": "outreach",
    "dealflow_name": "Spring Collection Promo",
    "picture_url": "https://imgp.sptds.icu/v2?mb0KwpL92uYofJiSjDn1%2F6peL1lBwv3s%2BUvShHERlDbrEEwrWumIvR20xZeZXa0LDeIrcniqZeG9S%2F1a5s2Rx3FZdXrWpY%2BmSBJp1l%2FmBGon3rcHA4EfuatZqMhVBzAT",
    "nr_followers": 60000,
    "full_name": "Dwayne Johnson",
    "platform": "instagram",
    "profile_url": "https://instagram.com/therock"
  },
  "is_ch_collab": false
}

Responses

The server processing the webhook should generally return a 200 status indicating successful receipt.