> For the complete documentation index, see [llms.txt](https://docs.explodely.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.explodely.com/api/create-affiliate-referral-contract.md).

# Create Affiliate Referral Contract

Affiliate API Endpoint:

`https://explodely.com/api/v1/aff` 

Parameters:

To create an affiliate referral contract (second tier affiliate contract), you need to send below parameters as POST to the affiliate API endpoint.

username - Your Explodely account username

apikey - Your Explodely account API key

apiaction - This should always be set as "createaffcontract"

contract\_name - Contract name (for your records)

partner\_username - Explodely affiliate ID of the partner

product - Either Explodely product ID for which contract needs to be made or "allproducts"

commission - Up to 80, the percentage of your share the partner will get

start\_date - Start date in format dd-mmm-yyyy (01-jan-2024), optional (default: starts right away)

end\_date - End date in format dd-mmm-yyyy (31-jan-2024), optional (default: active unless terminated)

max\_earnings - value of contract sales after which the contract will expire, optional

max\_sales - number of contract sales after which the contract will expire, optional

comments  - Comments visible inside Explodely seller contracts section, optional

activate - Activate contract immediately if set as yes, optional (default no)

mutual\_termination - If set as yes, the contract terminates after both partner approval, optional (default yes)

Responses:

The API endpoint returns a JSON object.

`{"error":"invalidapikey"}` - This is returned when the API key and username is not authenticated.

`{"error":"invalid_partnerusername"}` - This is returned when the provided partner\_username is not a valid Explodely affiliate account.

`{"error":"partner_contract_exists"}` - This is returned when an active contract with partner username already exists.

`{"error":"`duplicate\_contract`"}` - This is returned when the contract is already there.

`{"error":"`contract\_exists`"}` - This is returned when the contract for all products already exists.

`{"error":"`commission\_limit\_exceeded`"}` - This is returned when the percentage of your share for all contracts exceeds 80%

`{"error":"`failed`"}` - This is returned when the contract creation has failed.

`{"`contract\_created`":"ok", "contractid ":"12345"}` - This is returned when the contract has been created where 12345 would be replaced with contract ID of the actual contract which you can use later in other API requests.