SIGNUP Affiliate API VERSION 2

Updated on 2014-06-02
Current Version: Version 2
Deprecated Version: V1
Requests Allowed: GET&SOAP

 

Summary:

Returns Message: "Affiliate Added Successfully"


Resource/WSDL Page:

http://<your_domain_here>/api/2/signup.asmx?op=Affiliate


Parameters

api_key
Required
Type: STRING
Length (Max/Min): 50

Must be a valid API key (existing and NOT expired)

Example Values: Fo35NRAqvFLXoZxqB4aViaiYM7iVMhh

company_name
Required
Type: STRING
Length (Max/Min): 50

Company Name

Example Values: Affiliate Name

website
Required
Type: STRING
Length (Max/Min): 100

Affiliate Website

Example Values: www.affiliatewebsite.com

address_street
Required
Type: STRING
Length (Max/Min): 60

Only used if all address fields are non-NULL and non-empty

Example Values: 123 Pacific Coast Highway

address_street2
Required
Type: STRING
Length (Max/Min): 60

Only used if all address fields are non-NULL and non-empty

Example Values: Macarthur

address_city
Required
Type: STRING
Length (Max/Min): 30

Only used if all address fields are non-NULL and non-empty

Example Values: Newport Beach

address_state
Required
Type: STRING
Length (Max/Min): 20

Only used if all address fields are non-NULL and non-empty

Example Values: California

address_zip_code
Required
Type: STRING
Length (Max/Min): 10

Only used if all address fields are non-NULL and non-empty

Example Values: 92660

address_country
Required
Type: STRING
Length (Max/Min): 30

Only used if all address fields are non-NULL and non-empty

Example Values: United States

timezone
Required
Type: STRING
Length (Max/Min): 4

Only used if all contact fields are non-NULL and non-empty

Example Values: EST

referral_affiliate_id
Required
Type: INT
Length (max/Min): NA

0 to skip on edit

Example Values: 1234

referral_notes
Required
Type: STRING
Length (Max/Min): 50

Used on creation, NULL or empty skips on edit

Example Values: Referral Notes

tax_class
Required
Type: STRING
Length (Max/Min): 30

Tax Class ["Corporation", "Individual/Sole Proprietor", "Partners/LLC/LLP", "Other"]

Example Values: Corporation

 

payment_to
Required
Type: BYTE
Length (Max/Min): NA

Payment Entity ["0" = Company Name, "1" = Main Contact].  Not used if tipalti is enabled

Example Values: 0

ssn_taxid
Required
Type: STRING
Length (Max/Min): 20

SSN or Tax ID

Example Values: 123456789

   

first_name
Required
Type: STRING
Length (Max/Min): 25

 

Only used if all contact fields are non-NULL and non-empty

Example Values: Bob

last_name
Required
Type: STRING
Length (Max/Min): 25

Only used if all contact fields are non-NULL and non-empty

Example Values: Smith

 

email_address
Required
Type: STRING
Length (Max/Min): 60

 

Only used if all contact fields are non-NULL and non-empty

Example Values: bobwsmith@email.com

password
Required
Type: STRING
Length (Max/Min): 25

**Please note: Due to recent security updates, affiliates can only set their password via the CAKE reset password functionality. CAKE recommends not including this field on your form and passing a dummy value since the affiliate will need to set their own password once approved.

Example Values: abc123

contact_title
Required
Type: STRING
Length (Max/Min): 30

 

Only used if all contact fields are non-NULL and non-empty

Example Values: President

contact_phone_work
Required
Type: STRING
Length (Max/Min): 30

 

Only used if all contact fields are non-NULL and non-empty

Example Values: 212-555-1212

contact_phone_cell
Required
Type: STRING
Length (Max/Min): 30

 

Only used if all contact fields are non-NULL and non-empty

Example Values: 212-555-1212

contact_phone_fax
Required
Type: STRING
Length (Max/Min): 30

 

Only used if all contact fields are non-NULL and non-empty

Example Values: 212-555-1212

contact_im_name
Required
Type: STRING
Length (Max/Min): 30

Only used if all contact fields are non-NULL and non-empty

Example Values: bobwsmith

contact_im_service
Required
Type: INTEGER
Length (Max/Min): N/A

 

Only used if all contact fields are non-NULL and non-empty

Example Values: 2

media_type_ids
Required
Type: STRING
Length (Max/Min): NA

Media Type IDs [can be comma-separated] {See get.asmx > GetMediaTypes}

Example Values: media type

price_format_ids
Required
Type: STRING
Length (Max/Min): NA

Price Format IDs [can be comma-separated] {See get.asmx > GetPriceFormats}

Example Values: price format

primary_vertical_category
Required
Type: STRING
Length (Max/Min): NA

Vertical Category IDs [can be comma-separated] {See get.asmx > GetVerticalCategories}

Example Values: vertical category

countries
Required
Type: STRING
Length (Max/Min): NA

This should be a comma separated list of country codes

Example Values: US, CA

ip_address
Required
Type: STRING
Length (Max/Min): 15

Required if online_signup is true

Example Values: 12.34.567.89

account_status
Required
Type: INTEGER
Length (Max/Min): NA

Affiliate Account Status ID. Must be 1-3.

Example Values: 1

 

notes
Required
Type: STRING
Length (Max/Min): NA

Freeform notes.  Used on creation, NULL or empty skips on edit

Example Values: Notes

 **Note all optional parameters still need to be passed through in the actual call. These parameters do not need a value (therefore you can use a null value). 

 

Example Request

GET

https://demo.cakemarketing.com/api/2/signup.asmx/Affiliate?api_key=dNJFmId9rI&company_name=CPA%20API&website=http://getCAKE.com&address_street=2244+West+Coast+Highway&address_street2=STE+250&address_city=Newport+Beach&address_state=CA&address_zip_code=92663&address_country=US&timezone=PST&referral_affiliate_id=4401&referral_notes=Great+referral+here&tax_class=Other&payment_to=1&ssn_taxid=565579584&first_name=Andy&last_name=Worford&email_address=andy123456789@getCAKE.com&password=a069gsSDG9&contact_title=Head+of+QA&contact_phone_work=9495482253+x204&contact_phone_cell=9493512600&contact_phone_fax=9495152010&contact_im_name=cake_andy&contact_im_service=1&media_types=15,7,6&price_formats=1,2,4&vertical_categories=1,2,20&countries=US,CA,AF&ip_address=8.8.8.8&account_status=1&notes=Here+is+where+I%27m+putting+my+notes

 

Sample XML Response:

<string>Affiliate Added Successfully</string>

 

Example Error Messages: 

Error Message

Likely Cause

Invalid API Key

API key does not exist or is expired

Missing Fields

Returns the name of the fields that are missing input.

Fields Exceed Max Input Length

Returns the list of the fields that exceed the maximum characters allowed.

Invalid Email Address

Email address is invalid or already exists.

Duplicate Affiliate Contact

Affiliate already exists.