---
title: "Send 2FA PIN code over Email"
method: POST
path: "/2fa/2/pin/email"
tags: ["platform", "2fa", "pin-sending-and-verification", "send-pin-over-email"]
---

# Send 2FA PIN code over Email

`POST /2fa/2/pin/email`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/2fa/2/pin/email`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`
  - API key in header `Authorization`
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Send a PIN code over Email using previously created [Email message template](#channels/sms/2fa/2fa-configuration/create-2fa-email-message-template).

## Request body

- Aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6eStartEmailAuthenticationRequest
  - `applicationId` string, required: The ID of the application that represents your service, e.g. 2FA for login, 2FA for changing the password, etc.
  - `from` string: Use this parameter if you wish to override the sender from the [created](#channels/sms/create-2fa-email-message-template) Email message template parameter `from`.
  - `landingPagePlaceholders` object: Key value pairs that will be replaced when using personalized opt out landing page. Placeholder keys should NOT contain curly brackets and should NOT contain a `pin` placeholder. Valid example: `"landingPagePlaceholders":{"name":"John", "surname": "Smith"}`
  - `messageId` string, required: The ID of the Email message template (message with the PIN placeholder) that is sent to the recipient.
  - `placeholders` object: Key value pairs that will be replaced during message sending. Placeholder keys should NOT contain curly brackets and should NOT contain a `pin` placeholder. Valid example: `"placeholders":{"firstName":"John"}`
  - `to` string, required: Email address to which the 2FA message will be sent. Example: john.smith@example.com.

## Response `200`

successful response

- Aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6eStartEmailAuthenticationResponse
  - `emailStatus` Aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6eEmailStatus
    - `description` string: Human-readable description of the status.
    - `name` string: [Status name](https://www.infobip.com/docs/essentials/response-status-and-error-codes).
  - `pinId` string: Sent PIN code ID.
  - `to` string: Email address to which the 2FA message has been sent. Example: john.smith@example.com.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error
- `4XX`: Error responses
- `5XX`: Error responses

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)