SIGNUP Affiliate API Version 1 (DEPRECATED) : CAKE

SIGNUP Affiliate API Version 1

Updated on 2014-06-02
Current Version: Version V4
Deprecated Version: V1, V2, V3
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.