nsindocs Search the docs⌘K
  1. Docs
  2. API reference
  3. Email Routing

Verify a destination from its emailed link

posthttps://api.nsin.ir/email-routing/destinations/verify

No authentication.

Consumes the token from the verification mail. No authentication — the person clicking owns the destination mailbox and need not be an NSIN user; the single-use 256-bit token is the proof. Once verified, rules pointing at the destination go live within a minute.

Request body

Content type: application/json · required

  • tokenstringrequired

    The 64-character token from the emailed link.

Responses

200Verified.

Content type: application/json

  • emailstring
  • verifiedboolean
json
{
  "email": "string",
  "verified": true
}
400Malformed token.

Content type: application/json

  • errorstringrequired

    Human-readable description of what went wrong.

json
{
  "error": "read-only API key"
}
410The link expired or was already used.

Content type: application/json

  • errorstringrequired

    Human-readable description of what went wrong.

json
{
  "error": "read-only API key"
}

Example request

bash
curl -X POST "https://api.nsin.ir/email-routing/destinations/verify" \
  -H "Authorization: Bearer $NSIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "token": "string"
}'
esc