SIGNUP Affiliate API Version 2 (DEPRECATED)

Ron Torres

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

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: [email protected]
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 protected]&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.