Update an account

Updates a company's information by setting the values of the parameters passed. Any parameters not provided will be left unchanged. For example, if you pass the CompanyName parameter, that parameter will become the company's name, leaving all other parameters unchanged. Changing your company name updates your marketplace listing with your new name, and will become the new name for the partner account.

🚧

Note

These parameters cannot be updated via API, but can be updated in the impact.com UI:

  • FinancialContact
  • TechnicalContact
  • CommercialContact

Parameters

CompanyName optional

The name used for the account, which is usually the legal name for the associated company.

PrimaryPromotionalMethod optional

Partner's primary promotional method, specified by the partner.

View possible enum values
Possible enum values
EMAILPartner promotes via email.
SEARCHPartner promotes via search results.
LOYALTYPartner promotes via loyalty sub-affiliates.
COUPONPartner promotes via coupons and promo codes.
SYNDICATION_BLOG_NETWORKSPartner promotes via blogs, news sites, and other syndicated networks.
CPA_NETWORKPartner promotes via a cost-per-action network.
MOBILEPartner promotes via mobile apps and devices.
CONTENTPartner promotes via their own content.
SHOPPINGPartner promotes via shopping platforms and websites.
SOCIAL_MEDIA_INFLUENCERPartner promotes via social media as an influencer.
SERVICE_PROVIDERPartner promotes as a service provider of an affiliate network.
CONSUMER_SOFTWAREPartner promotes via consumer software.
INCENTIVIZEDPartner promotes as an incentivized affiliate.
OFFLINEPartner promotes via offline methods, like TV and radio.
OTHERPartner promotes via other methods not listed in impact.com.
CASHBACKPartner promotes as a cashback partner, offering a percentage of their payouts to customers.

PromotionalMethod optional

Partner's promotional method, specified by the partner.

View possible enum values
Possible enum values
EMAILPartner promotes via email.
SEARCHPartner promotes via search results.
LOYALTYPartner promotes via loyalty sub-affiliates.
COUPONPartner promotes via coupons and promo codes.
SYNDICATION_BLOG_NETWORKSPartner promotes via blogs, news sites, and other syndicated networks.
CPA_NETWORKPartner promotes via a cost-per-action network.
MOBILEPartner promotes via mobile apps and devices.
CONTENTPartner promotes via their own content.
SHOPPINGPartner promotes via shopping platforms and websites.
SOCIAL_MEDIA_INFLUENCERPartner promotes via social media as an influencer.
SERVICE_PROVIDERPartner promotes as a service provider of an affiliate network.
CONSUMER_SOFTWAREPartner promotes via consumer software.
INCENTIVIZEDPartner promotes as an incentivized affiliate.
OFFLINEPartner promotes via offline methods, like TV and radio.
OTHERPartner promotes via other methods not listed in impact.com.
CASHBACKPartner promotes as a cashback partner, offering a percentage of their payouts to customers.

Website optional

The website listed for the partner.

PrimaryPhoneNumber optional

Listed phone number to contact the partner.

PrimaryPhoneNumberCountry optional

Two-letter ISO 3166-1 alpha-2 country code of the partner's address.

SecondaryPhoneNumber optional

Another listed phone number to contact the partner.

SecondaryPhoneNumberCountry optional

Two-letter ISO 3166-1 alpha-2 country code of the partner's address.

MinimumContactRating optional

The lowest rating you can assign to a Partner conversation.

OrganizationType optional

Organization type for the account. Available options will vary depending on the country that the business is registered in.

View possible enum values
Possible enum values
NONP_GOVNon-Profit/Government, United States
CORPC Corporation, United States
SOLE_INDIndividual/Sole Proprietor, United States
LLC_LLP_LLSLimited Liability Company / Limited Liability Partnership / S Corporation, United States
TRUSTTrust company, United States
SOLE_TRDSole Trader, Non-US
PARTNERSPartnership, Non-US
LLCLimited Liability Company, Non-US
LLPLimited Liability Partnership, Non-US
COMPANYCompany, Non-US
GOVERNMENTGovernment, Non-US
OTHEROther classification, All countries

EinSsnForeginTaxId optional

Employer Identification Number for the account, or in some cases, the Social Security Number (SSN) of the company owner, or a Tax ID number for non-US companies.

CorporateAddress optional

The primary address for the account.

View child attributes

AddressLine1 string

Address line 1 (address number, street name)

AddressLine2 string

Address line 2 (building, unit, suite, etc. number)

City string

City, district, suburb, town, or village

State string

State or territory

PostalCode string

ZIP or postal code

Country enum

Two-letter country code. See ISO 3166-1 alpha-2.

BillingAddress optional

The billing address for the account.

View child attributes

AddressLine1 string

Address line 1 (address number, street name)

AddressLine2 string

Address line 2 (building, unit, suite, etc. number)

City string

City, district, suburb, town, or village

State string

State or territory

PostalCode string

ZIP or postal code

Country enum

Two-letter country code. See ISO 3166-1 alpha-2.

FinancialContact optional

A financial contact for the account (e.g., CFO).

View child attributes

UserId string

Unique impact.com member account ID for the user.

Name string

The contact's full name.

Email string

The contact's email address.

WorkPhoneNumber string

Financial contact's work phone number.

WorkPhoneNumberCountry enum

Two-letter country code for the work phone number. See ISO 3166-1 alpha-2.

CellPhoneNumber string

Financial contact's cellphone number.

CellPhoneNumberCountry enum<

Two-letter country code for the cell phone number. See ISO 3166-1 alpha-2.

TechnicalContact optional

A technical contact for the account (e.g., CTO).

View child attributes

UserId string

Unique impact.com member account ID for the user.

Name string

The contact's full name.

Email string

The contact's email address.

WorkPhoneNumber string

The contact's work phone number.

WorkPhoneNumberCountry enum

Two-letter country code. See ISO 3166-1 alpha-2.

CellPhoneNumber string

The contact's cell phone number.

CellPhoneNumberCountry enum

Two-letter country code. See ISO 3166-1 alpha-2.

CommercialContact optional

A commercial or marketing contact for the account (e.g., CMO).

View child attributes

UserId string

Unique impact.com member account ID for the user.

Name string

The contact's full name.

Email string

The contact's email address.

WorkPhoneNumber string

The contact's work phone number.

WorkPhoneNumberCountry enum

Two-letter country code.See ISO 3166-1 alpha-2.

CellPhoneNumber string

The contact's cell phone number.

CellPhoneNumberCountry enum

Two-letter country code. See ISO 3166-1 alpha-2.

Example request

curl 'https://api.impact.com/Mediapartners/<AccountSID>/CompanyInformation' \
  -X PUT \
  -u '<AccountSID>:<AuthToken>' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'CompanyName=Acme Corporation' \
  -d 'Website=https://example.com' \
  -d 'PrimaryPhoneNumber=123456789' \
  -d 'PrimaryPhoneNumberCountry=US' \
  -d 'SecondaryPhoneNumber=012345678' \
  -d 'OrganizationType=CORP' \
  -d 'EinSsnForeginTaxId=123456789' \
  -d 'CorporateAddressAddressLine1=42 Wallaby Way' \
  -d 'CorporateAddressCity=Sydney' \
  -d 'BillingAddressAddressLine1=742 Evergreen Terrace' \
  -d 'BillingAddressCity=Springfield'

Example response

{
  "Status": "OK",
  "Uri": "/Mediapartners/<AccountSID>/CompanyInformation/"
}