sinch-api-verification-check

Reports a user-entered verification code to the Sinch Verification API to complete phone verification.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Completing a phone number verification requires submitting the code the user received (via SMS, flash call, or callout) back to the Sinch Verification API. Doing this manually means crafting an authenticated PUT request with the correct verification ID and payload structure, which is error-prone and slow. ## Core Features & Use Cases - Code Submission: Reports the verification code entered by the user to the Sinch Verification API using the verification ID from the start step. - Multiple Methods: Supports sms, flashcall, and callout verification methods with the appropriate request body. - Clear Result Handling: Returns explicit success, invalid-code, and error messages for 400, 401, and 404 responses. - Use Case: After starting an SMS verification for a new user signup, the user receives a PIN. Run this command with the verification ID and the PIN to confirm the phone number and complete the signup flow. ## Quick Start Ask the assistant to report verification code 1234 for verification ID VERIFICATION_ID using the Sinch Verification API.

Frequently Asked Questions about sinch-api-verification-check

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

FAQPage Schema
How do I complete a Sinch phone verification with a code?

Send a PUT request to /verification/v1/verifications/id/{verificationId} with Basic Auth using your application key and secret, including the method and the code the user entered. This command performs that request directly given the verification ID and code.

How to verify an SMS PIN code with the Sinch Verification API?

Provide the verification ID returned by the start command and the PIN the user received via SMS. The request body contains method "sms" and the code, and a successful response confirms the phone number.

What credentials does the Sinch Verification API require?

It requires a Verification API application key and secret, sent as Basic Auth. If these environment variables are missing, the command reports that the Verification API is not configured.

Why does Sinch verification report an invalid or expired code?

The API returns an error when the entered code does not match, has expired, or the verification ID is unknown (404). Re-request a new code via the start command and submit the latest code promptly.

Does Sinch verification support flashcall and callout methods?

Yes, the method parameter accepts sms, flashcall, or callout, defaulting to sms. The request body is adjusted to match the selected method's expected payload.