Refersion Affiliate API
Official vendor OpenAPI document · agent-readyMarketingEmail MarketingapiKey15 EndpointsREST
For Agents
Programmatically create a new affiliate, get affiliate details. Covers 15 operations with apiKey authentication.
Use for: I need to a new affiliate, I want to affiliate details, Search for edit affiliate details, Find all affiliates
Not supported: Does not handle payments, communications, or crm - use for marketing only.
Refersion REST API v2 for managing affiliates, conversions, and commissions in your affiliate marketing program. The API exposes 15 endpoints secured with apiKey authentication.
Install Jentic One Beta
Connect the Refersion Affiliate API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Refersion Affiliate API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Frefersion.com%2Frefersion" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Frefersion.com%2Frefersion" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Refersion Affiliate API.
Create a new affiliate
Get affiliate details
Edit affiliate details
Search affiliates
List all affiliates
Change affiliate status
Use Cases
Patterns agents use Refersion Affiliate API for, with concrete tasks.
★ Marketing Operations
Use the Refersion Affiliate API to perform marketing operations programmatically. The API provides 15 endpoints covering core functionality including create a new affiliate, get affiliate details, edit affiliate details.
Call POST /affiliate/new to create a new affiliate
Automated Affiliates Management
Automate affiliates operations by combining multiple Refersion Affiliate API endpoints. Agents can get affiliate details and then edit affiliate details in a single workflow.
Call POST /affiliate/get to get affiliate details, then verify the result
AI Agent Integration via Jentic
AI agents discover and call Refersion Affiliate API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle apiKey tokens manually.
Search Jentic for 'create a new affiliate', load the operation schema, and execute with Jentic-managed credentials
Key Endpoints
15 endpoints — refersion rest api v2 for managing affiliates, conversions, and commissions in your affiliate marketing program.
METHOD
PATH
DESCRIPTION
POST
/affiliate/new
Create a new affiliate
POST
/affiliate/get
Get affiliate details
POST
/affiliate/edit
Edit affiliate details
POST
/affiliate/search
Search affiliates
POST
/affiliate/list
List all affiliates
POST
/affiliate/status_change
Change affiliate status
POST
/conversion/manual_credit
Create manual commission credit
POST
/conversion/status_change
Change conversion status
POST
/affiliate/new
Create a new affiliate
POST
/affiliate/get
Get affiliate details
POST
/affiliate/edit
Edit affiliate details
POST
/affiliate/search
Search affiliates
POST
/affiliate/list
List all affiliates
POST
/affiliate/status_change
Change affiliate status
POST
/conversion/manual_credit
Create manual commission credit
POST
/conversion/status_change
Change conversion status
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Refersion Affiliate API by hand means sending two separate headers on every call, the Refersion-Public-Key and the Refersion-Secret-Key, and handling retries against the api.refersion.com host yourself. Through Jentic you install once, import the Refersion Affiliate API from the API Directory, store the public and secret keys once, and your agent calls it.
Permission scoping
The Refersion Affiliate API uses action endpoints like /affiliate/new and /affiliate/edit with the target in the request body, so scoping is by operation: limit the agent to the operations it needs, such as listing or searching affiliates, rather than to a single affiliate. State-changing operations like editing an affiliate or changing a conversion status are only available if you include them.
Credential isolation
Your Refersion Affiliate API public and secret keys are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'create a new affiliate' or 'search affiliates', and Jentic returns the matching Refersion Affiliate API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Refersion Affiliate API through Jentic.
What authentication does the Refersion Affiliate API use?
The Refersion Affiliate API uses an API key passed in the `Refersion-Public-Key` header. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.
Can I create a new affiliate with the Refersion Affiliate API?
Yes. Use the POST /affiliate/new endpoint. The API returns structured JSON responses that agents can parse and act on directly.
What are the rate limits for the Refersion Affiliate API?
Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.
How do I create a new affiliate through Jentic?
Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'create a new affiliate'. Jentic returns the matching Refersion Affiliate API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.
How many endpoints does the Refersion Affiliate API have?
The Refersion Affiliate API exposes 15 endpoints covering affiliates, conversions, offers operations.
Can I limit what my agent is allowed to do with the Refersion Affiliate API?
Yes. Because you run Jentic One yourself, your own rules decide which Refersion Affiliate API operations and credentials the agent may use. This API scopes by operation, so you can allow read-only calls like listing or searching affiliates while withholding state-changing ones such as creating or editing an affiliate or changing a conversion status. Only the operations you explicitly include are available to the agent.
GET STARTED