REST API
Webhooks
Help Center →
Search…
Introduction
JavaScript API
Overview
REST API
Overview
Affiliates
Affiliate Links
The affiliate link object
List affiliate links
Create affiliate link
Retrieve affiliate link
Update affiliate link
Referrals
Commissions
Webhooks
Overview
Endpoints
Requests
Event types
Signed webhooks
Links
Help Center
Sign up
Login
Learn more about Rewardful
Powered By
GitBook
Create affiliate link
Creates a new affiliate link in your account with the specified parameters.
Creating additional affiliate links is only available on
Growth and Enterprise plans
.
Request
Method
URL
POST
https://api.getrewardful.com/v1/affiliate_links
Parameters
Parameter
Required?
Description
affiliate_id
Yes
The ID of the affiliate this link should be associated with.
token
No
Alphanumeric code to be used for this link. Must contain only letters, numbers, and dashes. A unique token will be generated if this parameter is left blank.
Example
curl
--request POST
\
--url https://api.getrewardful.com/v1/affiliate_links
\
-u YOUR_API_SECRET:
\
-d
affiliate_id
=
f46a912b-08bc-4332-8771-c857e11ad9dd
\
-d
token
=
luke-skywalker
Response
Success
Failures
Response code
Body
200
An
affiliate link object
(JSON)
Invalid parameters
Response code
Body
422
JSON object describing validation errors.
{
"error"
:
"Could not create affiliate link."
,
"details"
:
[
"Token is already in use."
]
}
Authentication failure
Response code
Body
401
Description of the authentication failure.
{
"error"
:
"Invalid API Secret."
}
Previous
List affiliate links
Next
Retrieve affiliate link
Last modified
4mo ago
Export as PDF
Copy link
Outline
Request
Parameters
Example
Response