---
title: "Create Referral Sender"
method: POST
path: "/stores/{subscriberId}/referral_senders"
tags: ["referrals"]
---

# Create Referral Sender

`POST /stores/{subscriberId}/referral_senders`

## Request

- Base URL: `https://api.okendo.io/enterprise`
- URL: `https://api.okendo.io/enterprise/stores/{subscriberId}/referral_senders`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/okendo/apis/okendo-enterprise-api/docs/stores/:subscriberId/referral_senders/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `subscriberId` string, required

## Headers

- `okendo-api-version` '2025-02-01', required
- `okendo-partner-id` string

## Request body

- object
  - `email` string, email, required

## Response `200`

Successfully created referral sender

- object
  - `referralSenderId` string, uuid, required: The Referral Sender ID is required for sending referral requests via authenticated endpoints
  - `shareableLinkUrl` string, uri, required: A URL which can be sent as a referral link

## Other responses

- `400`: Bad Request - Invalid email address

---

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