Skip to content
/
Update Deal Stage

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

Create Task

Request

Creates a new task on a deal.

Security
ApiKeyAuth
Bodyapplication/jsonrequired
deal_idstringrequired

The ID of the deal to add the task to.

Example: "ETUNQ6ZTW1"
tasktypestringrequired

The type of task. Use "todo_task" for a standard task or "wait_task" for a waiting/follow-up task.

Enum"todo_task""wait_task"
Example: "todo_task"
task_titlestringrequired

The title of the task.

Example: "Follow up on product shipment"
task_descriptionstringrequired

A detailed description of the task.

Example: "Confirm that the product was received and schedule the content creation call."
deadlinestringrequired

The deadline for the task in DD-MM-YYYY format.

Example: "25-12-2025"
assigned_tostring or nullrequired

The user ID to assign the task to. Can be null for unassigned tasks.

Example: "user_123"
curl -i -X POST \
  https://api.influencer-hero.com/v1/crm/create_task \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "deal_id": "ETUNQ6ZTW1",
    "tasktype": "todo_task",
    "task_title": "Follow up on product shipment",
    "task_description": "Confirm that the product was received and schedule the content creation call.",
    "deadline": "25-12-2025",
    "assigned_to": "user_123"
  }'

Responses

Task successfully created.

Bodyapplication/json
Response
application/json
{
  "message": "Successfully created task"
}

Update Deal Stage

Request

Updates the funnel stage or the dealflow of a deal

Security
ApiKeyAuth
Bodyapplication/jsonrequired
deal_idstringrequired

The ID of the deal to update.

Example: "ETUNQ6ZTW1"
new_stageintegerrequired

The new funnel stage for the deal.

Example: 3
dashboard_idstring

Optional. The dealflow ID to move the deal to. If provided, the deal will be moved to this dealflow.

Example: "D_FSSI4P"
curl -i -X POST \
  https://api.influencer-hero.com/v1/crm/update_dealstage \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "deal_id": "ETUNQ6ZTW1",
    "new_stage": 3,
    "dashboard_id": "D_FSSI4P"
  }'

Responses

Deal stage successfully updated.

Bodyapplication/json
Response
application/json
{
  "message": "Deal stage successfully updated",
  "ugc_tracking_activated": false
}

Update Deal Info

Request

Updates the contact and profile information for an influencer deal. Use status_update_only: true to only update the active status without modifying other fields.

Security
ApiKeyAuth
Bodyapplication/jsonrequired
deal_idstringrequired

The ID of the deal to update.

Example: "ETUNQ6ZTW1"
status_update_onlyboolean

If true, only updates the is_active status and ignores other fields.

Example: false
new_deal_infoobjectrequired

The updated deal information.

new_deal_info.​is_activeboolean

Whether the deal is active.

Example: true
new_deal_info.​main_namestring

The influencer's display name or handle.

Example: "therock"
new_deal_info.​notesstring

Internal notes about the deal.

Example: "Great engagement on recent posts"
new_deal_info.​emailstring

Primary email address.

Example: "contact@therock.com"
new_deal_info.​other_emailsstring

Additional email addresses.

Example: "manager@therock.com"
new_deal_info.​first_namestring

Influencer's first name.

Example: "Dwayne"
new_deal_info.​last_namestring

Influencer's last name.

Example: "Johnson"
new_deal_info.​address_linestring

Street address.

Example: "123 Main St"
new_deal_info.​citystring

City.

Example: "Los Angeles"
new_deal_info.​postcodestring

Postal code.

Example: "90001"
new_deal_info.​regionstring

State or region.

Example: "California"
new_deal_info.​countrystring

Country.

Example: "USA"
new_deal_info.​phone_nrstring

Phone number.

Example: "+1234567890"
new_deal_info.​has_managerboolean

Whether the influencer has a manager.

Example: true
new_deal_info.​manager_firstnamestring

Manager's first name.

Example: "John"
new_deal_info.​manager_lastnamestring

Manager's last name.

Example: "Smith"
new_deal_info.​manager_emailstring

Manager's email address.

Example: "john.smith@agency.com"
new_deal_info.​other_informationstring

Any other relevant information.

Example: "Preferred contact via manager"
curl -i -X POST \
  https://api.influencer-hero.com/v1/crm/update_deal_info \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "deal_id": "ETUNQ6ZTW1",
    "status_update_only": false,
    "new_deal_info": {
      "is_active": true,
      "main_name": "therock",
      "notes": "Great engagement on recent posts",
      "email": "contact@therock.com",
      "other_emails": "manager@therock.com",
      "first_name": "Dwayne",
      "last_name": "Johnson",
      "address_line": "123 Main St",
      "city": "Los Angeles",
      "postcode": "90001",
      "region": "California",
      "country": "USA",
      "phone_nr": "+1234567890",
      "has_manager": true,
      "manager_firstname": "John",
      "manager_lastname": "Smith",
      "manager_email": "john.smith@agency.com",
      "other_information": "Preferred contact via manager"
    }
  }'

Responses

Deal info successfully updated.

Bodyapplication/json
messagestring
deal_infoobject

The updated deal information.

Response
application/json
{
  "message": "Successfully updated deal info",
  "deal_info": {
    "deal_id": "ETUNQ6ZTW1",
    "main_name": "therock",
    "email": "contact@therock.com"
  }
}

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