canonical: https://jentic.com/apis/refersion.com/refersion

# Refersion Affiliate API

Refersion REST API v2 for managing affiliates, conversions, and commissions in your affiliate marketing program. The API exposes 15 endpoints secured with apiKey authentication.

## For AI agents

Programmatically create a new affiliate, get affiliate details. Covers 15 operations with apiKey authentication.

## Scope

Does not handle payments, communications, or crm - use for marketing only.

## Capabilities

- Create a new affiliate
- Get affiliate details
- Edit affiliate details
- Search affiliates
- List all affiliates
- Change affiliate status

## Use cases

### 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.

Example prompt: 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.

Example prompt: 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.

Example prompt: Search Jentic for 'create a new affiliate', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| 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 |

## Key resources

- **Affiliates** — Affiliate management operations
- **Conversions** — Conversion and commission operations
- **Offers** — Offer and SKU commission management
- **Reporting** — Report generation and download

## Why Jentic

- **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 handling:** 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.
- **Discovery method:** 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

- **Mailchimp** — Alternative marketing API
- **Hubspot** — Alternative marketing API

## FAQ

### 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.