FirstPromoter icon

FirstPromoter

Interact with the official FirstPromoter APIs

Actions35

Promoter → Update Promoters

AI-generated

Summary

Update a promoter's details in FirstPromoter by finding the promoter using an attribute such as Auth Token, Email, ID, Promo Code, or Referral Token, then specifying the new values for the promoter's profile and other optional fields to modify.

Inputs

  • Find by Attribute (required) — Select the attribute to locate the promoter (Auth Token, Email, ID, Promo Code, or Referral Token).
  • Attribute Value (required) — The value corresponding to the chosen attribute to identify the promoter to update.
  • First Name — New first name of the promoter.
  • Last Name — New last name of the promoter.
  • Cust ID — New customer ID to link with the promoter in your customer's database.
  • Website — New website URL of the promoter.
  • Company Name — New company name for the promoter.
  • Company Registration Number — New company registration number.
  • Phone Number — New phone number for the promoter.
  • VAT ID — New VAT ID of the promoter.
  • Country — New country code (2 characters, e.g., US, UK).
  • Address — New address details.
  • Avatar — New URL to the promoter's avatar image.
  • W8 Form URL — New URL to the W8 form, if available.
  • W9 Form URL — New URL to the W9 form, if available.
  • Description — New description for the promoter.
  • Instagram URL — New Instagram URL of the promoter.
  • YouTube URL — New YouTube URL.
  • LinkedIn URL — New LinkedIn URL.
  • Facebook URL — New Facebook URL.
  • Twitter URL — New Twitter URL.
  • Twitch URL — New Twitch URL.
  • TikTok URL — New TikTok URL.
  • Destroy W8 Form — Whether to remove the existing W8 form.
  • Destroy W9 Form — Whether to remove the existing W9 form.
  • Custom Fields — Custom key-value pairs defined in FirstPromoter settings, supporting string or array of strings as values.

Output shape

a single record

Returns the updated promoter data as a single JSON object wrapped in an array. The response reflects the promoter's current state after the update.

Examples

Example 1: Update promoter found by email with new first name and phone number

Set Find by Attribute to Email with the respective email address, and specify the First Name and Phone Number fields with new values.

Links

Discussion