---
title: "Add identifier to the allow-list"
method: POST
path: "/allowlist_identifiers"
tags: ["Allow-list / Block-list"]
---

# Add identifier to the allow-list

`POST /allowlist_identifiers`

Create an identifier allowed to sign up to an instance

## Request body

- object
  - `identifier` string, required — The identifier to be added in the allow-list. This can be an email address, a phone number, or a web3 wallet.
  - `notify` boolean — This flag denotes whether the given identifier will receive an invitation to join the application. Note that this only works for email address and phone number identifiers.

## Response `200`

Success

- AllowlistIdentifier
  - `object` 'allowlist_identifier' — String representing the object's type. Objects of the same type share the same value.
  - `id` string
  - `invitation_id` string
  - `identifier` string — An email address or a phone number.
  - `identifier_type` 'email_address' | 'phone_number' | 'web3_wallet'
  - `instance_id` string
  - `created_at` integer — Unix timestamp of creation
  - `updated_at` integer — Unix timestamp of last update.

## Other responses

- `400` — Request was not successful
- `402` — Payment required
- `422` — Invalid request parameters

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/versions/cf036e7951d3/schema)