---
title: "Queues an insertion of a new identity into the merkle tree"
method: POST
path: "/insertIdentity"
---

# Queues an insertion of a new identity into the merkle tree

`POST /insertIdentity`

## Request body

- IdentityCommitment
  - `identityCommitment` string

## Response `202`

Identity insert was successfully queued

- InclusionProof
  - `status` 'new' | 'failed' | 'pending' | 'mined'
  - `root` string
  - `proof` union[]
    - union
      - object
        - `Left` string
      - object
        - `Right` string

## Other responses

- `400` — Invalid request

## Changes

- **2023-05-29** `8e437603378d` — 2 warning, 1 info
  - added the new `failed` enum value to the `status` response property for the response status `202`
  - added the new `new` enum value to the `status` response property for the response status `202`
  - removed the `confirmed` enum value from the `status` response property for the response status `202`
- **2023-04-27** `f87d09a5062f` — 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `202`
- **2023-02-01** `c3529c08a9c7` — 2 warning, 1 info
  - removed the request property `groupId`
  - removed the optional property `validityScope` from the response with the `200` status
  - added the optional property `status` to the response with the `200` status
- **2023-01-23** `7eb112989fd6` — 1 breaking, 3 info
  - the response's body type/format changed from `null`/`` to `object`/`` for status `200`
  - added the optional property `proof` to the response with the `200` status
  - added the optional property `root` to the response with the `200` status
  - added the optional property `validityScope` to the response with the `200` status
- **2022-11-24** `f2fda934879a` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/worldcoin/apis/signup-sequencer/changes/insertIdentity/post.md)

---

[API](https://skmtc.dev/worldcoin/apis/signup-sequencer.md) · [All operations](https://skmtc.dev/worldcoin/apis/signup-sequencer/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/worldcoin/signup-sequencer/revisions/eb6bc98df64f/schema)