---
title: "Create recipient"
method: POST
path: "/api/v1/apps/{appId}/recipients"
tags: ["Recipients"]
---

# Create recipient

`POST /api/v1/apps/{appId}/recipients`

## Request

- Base URL: `https://api-docs.relin.app`
- URL: `https://api-docs.relin.app/api/v1/apps/{appId}/recipients`
- Auth: HTTP bearer

Create or update a recipient.

## Path parameters

- `appId` string, required

## Request body

- object
  - `externalId` string, required
  - `name` string

## Response `200`

JSON response

- object
  - `recipient` unknown

## Other responses

- `201`: JSON response
- `202`: JSON response
- `400`: Error response
- `401`: Error response
- `403`: Error response
- `404`: Error response

---

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