# Create affiliate link

{% hint style="info" %}
Creating additional affiliate links is only available on [Growth and Enterprise plans](https://www.rewardful.com/pricing).
{% endhint %}

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

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

{% tabs %}
{% tab title="Success" %}

| Response code | Body                                                                                                                   |
| ------------- | ---------------------------------------------------------------------------------------------------------------------- |
| 200           | An [affiliate link object](https://developers.rewardful.com/rest-api/affiliate-links/the-affiliate-link-object) (JSON) |
| {% endtab %}  |                                                                                                                        |

{% tab title="Failures" %}

### Invalid parameters

| Response code | Body                                      |
| ------------- | ----------------------------------------- |
| `422`         | JSON object describing validation errors. |

```javascript
{
  "error": "Could not create affiliate link.",
  "details": ["Token is already in use."]
}
```

### Authentication failure

| `401` | Description of the authentication failure. |
| ----- | ------------------------------------------ |

```javascript
{  "error": "Invalid API Secret." }
```

{% endtab %}
{% endtabs %}