---
title: "Create recipient"
method: POST
path: "/v4/lists/{listId}/recipients"
tags: ["Lists"]
---

# Create recipient

`POST /v4/lists/{listId}/recipients`

## Request

- Base URL: `https://api.inmobile.com`
- URL: `https://api.inmobile.com/v4/lists/{listId}/recipients`
- Auth: one of:
  - HTTP basic
  - API key in query parameter `apikey`

## Path parameters

- `listId` string, guid, required

## Request body

- RecipientCreateApiModel
  - `externalCreated` string: When the recipient was created in an external system e.g. 2001-02-30T14:50:23Z (UTC time).
  - `fields` RecipientFieldsCollection
  - `numberInfo` NumberInfo
    - `countryCode` string, required: The country code part of the number
    - `phoneNumber` string, required: The local phonenumber part of the number

## Response `200`

The created recipient

- RecipientOutputApiModel
  - `externalCreated` string: When the recipient was created in an external system e.g. 2001-02-30T14:50:23Z (UTC time).
  - `fields` RecipientFieldsCollection
  - `numberInfo` NumberInfo
    - `countryCode` string, required: The country code part of the number
    - `phoneNumber` string, required: The local phonenumber part of the number
  - `id` string, guid: The id of the recipient.
  - `listId` string, guid: The id of the list that the recipient belongs to.
  - `created` string: When the recipient was created e.g. 2001-02-30T14:50:23Z (UTC time).

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: Not found
- `409`: Conflict
- `500`: Internal server error

---

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