FirstPromoter icon

FirstPromoter

Interact with the official FirstPromoter APIs

Actions35

Promoter → Create Promoter

AI-generated

Summary

Create a new promoter in the FirstPromoter system by providing their email, first name, and optionally other details like last name, company information, social media URLs, and campaign assignment.

Inputs

  • Email (required) — Email address of the promoter.
  • First Name (required) — First name of the promoter.
  • Last Name — Last name of the promoter.
  • Cust ID — ID of the promoter in your customer's database to link with the promoter.
  • Initial Campaign ID — ID of the initial campaign to which the promoter is assigned.
  • Drip Emails — Boolean indicating whether a welcome email should be sent to the promoter.
  • Website — Website URL of the promoter.
  • Company Name — Company name of the promoter.
  • Company Registration Number — Registration number of the promoter's company.
  • Phone Number — Phone number of the promoter.
  • VAT ID — VAT identification number of the promoter.
  • Country — Two-character country code (e.g., US, UK, CA) of the promoter.
  • Address — Physical address of the promoter.
  • Avatar — URL to the promoter's avatar image.
  • W8 Form URL — URL to the promoter's W8 tax form, if available.
  • W9 Form URL — URL to the promoter's W9 tax form, if available.
  • Description — Additional description for the promoter.
  • Instagram URL — Instagram profile URL of the promoter.
  • YouTube URL — YouTube channel URL of the promoter.
  • LinkedIn URL — LinkedIn profile URL of the promoter.
  • Facebook URL — Facebook profile URL of the promoter.
  • Twitter URL — Twitter profile URL of the promoter.
  • Twitch URL — Twitch channel URL of the promoter.
  • TikTok URL — TikTok profile URL of the promoter.

Output shape

a single JSON object representing the created promoter with all submitted and default attributes

Returns the created promoter data as an array with one JSON object. The operation requires 'email' and 'first name' parameters; all other fields are optional. If the API key or credentials are invalid, an error with a descriptive message is thrown.

Links

Discussion