Creates a new direct partner account, which automatically joins your impact.com program with a specified active contract.

Parameters

AccountName required

The name for the partner account that will appear in the platform and API. Different from the Username, which is what the partner will use to sign in to impact.com.

Website required

A URL to the partner's website. The protocol is required.

AddressLine1 required

The first address line is for the partner's physical address — usually an address number and street name combination.

City required

The city that the partner's address is in.

PostalCode required

The postal or ZIP code of the partner's address.

Country required

The country of the partner's address.

PhoneCountry required

The country of the partner's phone number.

PhoneNumber required

The partner's phone number.

PrimaryPromotionalMethod required

The primary Business Model that the partner uses.

Username required

A username that the partner will use to sign in to impact.com.

FirstName required

The first name of the person who will use this partner account.

LastName required

The last name (or surname) of the person who will use this partner account.

Password required

A case-sensitive password that the partner will use to sign in to impact.com.

• Minimum of eight (8) characters
• Must have at least one (1) digit (e.g., 0-9)
• Must have at least one (1) symbol. (e.g., !,@,#, etc.).

Remind the partner to change their password immediately after signing in for the first time.

EmailAddress required

The email address of the person who will use this partner account.

TemplateTermsId required

This is the unique identifier of the contract that the partner will be joined with. This value can be found in the Contracts endpoint or on the Template Terms Name line of the PDF document of the terms. In the platform, go to:

Contracts → Template Terms → Actions
→ View Terms → Actions
→ Download PDF.

TaxId optional

The EIN/SSN/Foreign Tax ID associated with the individual or business that will use this partner account.

OrganizationType conditionally required

The type of organization that will use this partner account. Available options will vary depending on the country in which the business is registered.

• Required if the Country value is US, Canada, or CHINA.
• Required if the Country value is UK, IRELAND, or AUSTRALIA and a TaxId value is supplied.

AddressLine2 optional

Additional address line (e.g., apartment, suite, building number) for the address of the person who will use this account.

CountryState conditionally required

For US addresses, the state is the address of the person who will use this partner account.

• Required based on whether the country in question has states or provinces.

Currency required

The 3-letter ISO 4217 currency code of the partner's default currency.

Timezone optional

The time zone of the partner's account in the tz database format.

PromotingCountries optional

Comma-separated list of countries in 2-letter ISO 3166-1 alpha 2 format that the partner promotes in.

Description optional

A short description of the partner.

MPGroupIDs optional

This field should contain the unique identifiers of the partner groups that this partner will belong to.

• Submit the IDs in a comma-separated list, e.g., "111111, 222222, 333333".

MPValue1, MPValue2, MPValue3 optional

A custom value assigned to partners that can be appended as a query string parameter to all landing pages, depending on how both the Partner Tracking Template and Campaign Tracking Template are configured in:

This value is applied at the account level, meaning it remains the same across all of your campaigns (or programs) for partners. Learn more about Gateway Tracking Settings.

Returns

A successful call will return the status of the request and the URI to the newly created partner object. An unsuccessful call will return an error if any parameters are invalid or missing.

curl 'https://api.impact.com/Advertisers/<AccountSID>/MediaPartners' \
  -X POST \
  -u '<AccountSID>:<AuthToken>' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'AccountName=Hazel Influencer' \
  -d 'Website=https://www.example.com' \
  -d 'AddressLine1=1234 Elm Street' \
  -d 'City=Anytown' \
  -d 'PostalCode=87101' \
  -d 'Country=US' \
  -d 'PhoneCountry=US' \
  -d 'PhoneNumber=12065550100' \
  -d 'PromotionalMethods=SOCIAL_MEDIA_INFLUENCER,CONTENT' \
  -d 'Username=Hazel Influencer' \
  -d 'FirstName=Hazel' \
  -d 'LastName=Nutt' \
  -d 'Password=$h3!$Nutt$' \
  -d '[email protected]' \
  -d 'InsertionOrderId=12345' \
  -d 'OrganizationType=SOLE_IND'

{
  "Status": "OK",
  "Uri": "/Advertisers/<AccountSID>/MediaPartners/123456"
}