sinch-api-verification-start

Starts phone number verification via the Sinch Verification API using SMS, Flashcall, or Callout methods.

6|2|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/sinch/sinch-plugins --skill sinch-api-verification-start-sinch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sinch-api-verification-start
Source: https://github.com/sinch/sinch-plugins/tree/main/plugins/sinch-antigravity-plugin/skills/sinch-api-verification-start
Command: npx skills add https://github.com/sinch/sinch-plugins --skill sinch-api-verification-start-sinch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Initiating phone number verification requires constructing authenticated HTTP requests to the Sinch Verification API with the correct identity format, method, and credentials, which is error-prone when done manually. ## Core Features & Use Cases - Start Verifications: Trigger a phone verification via SMS PIN code, Flashcall (missed call), or Callout (voice TTS) with a single command. - Credential Handling: Reads VERIFICATION_APPLICATION_KEY and VERIFICATION_APPLICATION_SECRET from the environment and uses Basic Auth against the Verification API. - Error Handling: Reports clear messages for 400, 401, and 429 responses and flags missing configuration. - Use Case: A developer building a signup flow needs to verify a user's phone number; they run the command with the E.164 number and method, and the end user receives an SMS PIN or call to complete verification. ## Quick Start Ask the assistant to start a phone verification for +14155551234 using the sms method via the Sinch Verification API.

Frequently Asked Questions about sinch-api-verification-start

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start a phone verification with the Sinch Verification API?

Provide the phone number in E.164 format and a method (sms, flashcall, or callout). The skill sends a POST request to https://verification.api.sinch.com/verification/v1/verifications with Basic Auth using your application key and secret.

What verification methods does Sinch support?

This skill supports three methods: sms, which sends a PIN code by text message; flashcall, which triggers a missed call; and callout, which places a voice call with TTS. The method defaults to sms if not specified.

What credentials are required for the Sinch Verification API?

You need VERIFICATION_APPLICATION_KEY and VERIFICATION_APPLICATION_SECRET set as environment variables. These come from a Verification app in the Sinch dashboard and are used as Basic Auth credentials, distinct from Conversation API credentials.

Why does my Sinch verification request return a 401 error?

A 401 response means the application key or secret is missing or incorrect. Confirm both environment variables are set for the correct Verification app and that the credentials have not been rotated or revoked.

What phone number format does the Sinch Verification API require?

The number must be in E.164 format, such as +14155551234, including the country code and leading plus sign. The skill validates this format before sending the request.