---
title: "Create Representative Verification Link"
method: POST
path: "/entities/{entity_id}/representatives/{representative_id}/verification-link"
tags: ["Entities"]
---

# Create Representative Verification Link

`POST /entities/{entity_id}/representatives/{representative_id}/verification-link`

## Request

- Base URL: `https://api.meow.com/v1`
- URL: `https://api.meow.com/v1/entities/{entity_id}/representatives/{representative_id}/verification-link`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/meow/apis/meow-api/docs/entities/:entity_id/representatives/:representative_id/verification-link/post.ts> (a function with typed inputs; its response is checked against the schema)

Mint a shareable identity-verification link the representative opens to complete KYC themselves. The alternative to submitting their KYC data directly.

## Path parameters

- `representative_id` string, required: The representative, as returned in `representatives` on `GET /entities/{entity_id}`.
- `entity_id` string, required: The entity being onboarded.

## Response `200`

Successful Response

- EntityRepresentativeVerificationLinkResponse
  - `representative_id` string, uuid, required: ID of the representative the link is for.
  - `identity_verification_url` string, required: Shareable identity-verification link the representative opens to complete KYC themselves. A representative who cannot be given a link (already verified, or a verification already in progress from submitted KYC data) is rejected with an error explaining why, rather than returned here as null.

## Other responses

- `400`: The request could not be processed.
- `401`: Authentication failed.
- `403`: The API key is not authorized for this operation.
- `429`: Too many requests.

---

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