---
title: "Create a referred user"
method: POST
path: "/referrals"
tags: ["Referrals"]
---

# Create a referred user

`POST /referrals`

## Request

- Base URL: `https://refgrow.com/api/v1`
- URL: `https://refgrow.com/api/v1/referrals`
- Auth: HTTP bearer

## Request body

- object
  - `email` string, email, required
  - `affiliate_id` integer
  - `status` 'pending' | 'converted' | 'direct' | 'direct_signup'

## Response `201`

Created. Triggers `referral.created` webhook.

## Other responses

- `409`: Duplicate (email or code already exists)

---

[API](https://skmtc.dev/refgrow/apis/refgrow-api.md) - [All operations](https://skmtc.dev/refgrow/apis/refgrow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/refgrow/apis/refgrow-api/revisions/68cce63d08d2?raw)