CAKE Help & Support

SIGNUP Affiliate API Version 1 (DEPRECATED)

Modified on: Thu, 19 Nov, 2015 at 6:11 PM


SIGNUP Affiliate API Version 1

Updated on 2014-06-02
Current Version: Version 
V4
Deprecated Version: 
V1V2V3
Requests Allowed: GET&SOAP

 

Summary:

Returns Message: "Affiliate Added Successfully"


Resource/WSDL Page:

http://<your_domain_here>/api/1/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

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

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

0 to skip on edit

Example Values: 1234

 

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

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

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

Example Values: Corporation

 

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

SSN or Tax ID

Example Values: 123456789

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

Affiliate Website

Example Values: www.affiliatewebsite.com

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

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

Example Values: Notes

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
Required
Type: INTEGER
Length (Max/Min): NA

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

Example Values: media type

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

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

Example Values: price format

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

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

Example Values: vertical category

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

 

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

Example Values: vertical category

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

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

Example Values: 0

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

Required if online_signup is true

Example Values: 12.34.567.89

 
 

 **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/1/signup.asmx/Affiliate?api_key=dNJFmId9rI&company_name=CPA+API&address_street=2244+West+Coast+Highway&address_street2=STE+250&address_city=Newport+Beach&address_state=CA&address_zip_code=92663&address_country=US&referred_by=CPA%20Nostromo&first_name=Andy&last_name=Worford&email_address=andy980@getCAKE.com&password=a069gsSDG9&tax_class=Other&ssn_taxid=565579584&website=http://getCAKE.com&notes=Here+is+where+I%27m+putting+my+notes&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_type=15&price_format=1&primary_vertical_category=1&secondary_vertical_category=2&payment_to=0&ip_address=8.8.8.8

 

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.

 


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.
Login
New support ticket Check ticket status