---
title: "Initiate contact email verification"
method: POST
path: "/api/contacts/verify-email"
tags: ["Contacts"]
---

# Initiate contact email verification

`POST /api/contacts/verify-email`

## Request

- Base URL: `https://core-api.getaptly.com`
- URL: `https://core-api.getaptly.com/api/contacts/verify-email`
- Auth: one of:
  - API key in header `x-token`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/getaptly/apis/aptly-api/docs/api/contacts/verify-email/post.ts> (a function with typed inputs; its response is checked against the schema)

Looks up an email address against your org's contact database. If a match is found,
generates a cryptographically strong 6-digit code, sends it to the address, and
returns a `requestId` and `verifyUrl` to complete the verification.

The code expires after 10 minutes and can only be used once.

## Request body

- object
  - `email` string, required: The email address to verify.
  - `emailSubject` string: Subject line for the verification email. Defaults to "Your verification code".
  - `replyTo` string: Reply-To address for the verification email.
  - `emailHtml` string: Custom HTML body for the verification email. Supports two placeholders: `{{ verificationCode }}` — replaced with the 6-digit code. `{{ expirationTime }}` — replaced with the expiry duration (e.g. "10 minutes").

## Response `200`

Verification initiated — code sent to the email address.

- object
  - `requestId` string: Opaque ID used to complete the verification.
  - `verifyUrl` string: API path to POST the code to (relative URL).

## Other responses

- `400`: Missing or invalid email field.
- `401`: Invalid or missing API key.
- `404`: No contact found with that email address.
- `500`: Verification request was created but the email could not be delivered (EMAIL_SEND_FAILURE).

---

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