CtrlK
BlogDocsLog inGet started
Tessl Logo

sinch-partnerships-ecosystems/sinch-skills

Official Sinch API skills for AI coding agents — SMS, Voice, Verification, Numbers, Mailgun email, and more.

71

Quality

89%

Does it follow best practices?

Impact

—

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Overview
Quality
Evals
Security
Files

callbacks.mdskills/sinch-imported-numbers-hosting-orders/references/

Callback Payload Reference

Payload Structure

FieldTypeDescription
resourceTypestringIMPORTED_NUMBER or HOSTING_ORDER_NUMBER
eventTypestringSee event types below
eventIdstringUnique event ID
timestampISO 8601When the event was created (UTC)
projectIdstringProject ID
resourceIdstringPhone number, hosting order ID, or brand ID
statusstringSUCCEEDED or FAILED
failureCodestringOnly present when status is FAILED

Resource Types

  • IMPORTED_NUMBER — Numbers imported individually or previously imported successfully via hosting orders but later updated.
  • HOSTING_ORDER_NUMBER — Numbers that are imported as part of a hosting order.

Event Types

Event TypeDescription
PROVISIONING_TO_SMS_PLATFORMNumber linked to a Service Plan ID
DEPROVISIONING_TO_SMS_PLATFORMNumber unlinked from a Service Plan ID
LINK_TO_10DLC_CAMPAIGNNumber linked to a Campaign
UNLINK_TO_10DLC_CAMPAIGNNumber unlinked from a Campaign
HOSTING_PROCESSSuccess or failure of a number's hosting process
OSR_UPDATEOSR update performed for a number
DELETENumber deleted

Failure Codes

Only present when status is FAILED:

CodeDescription
CAMPAIGN_NOT_AVAILABLEThe specified campaign is not available
EXCEEDED_10DLC_LIMITExceeded the limit for 10DLC
NUMBER_PROVISIONING_FAILEDProvisioning the number failed
PARTNER_SERVICE_UNAVAILABLEThird party service is unavailable
CAMPAIGN_PENDING_ACCEPTANCECampaign not yet accepted
MNO_SHARING_ERRORError with MNO
CAMPAIGN_PROVISIONING_FAILEDCampaign failed to provision
CAMPAIGN_EXPIREDCampaign expired
CAMPAIGN_MNO_REJECTEDCampaign MNO was rejected
CAMPAIGN_MNO_SUSPENDEDCampaign MNO was suspended
CAMPAIGN_MNO_REVIEWCampaign MNO is under review
INSUFFICIENT_BALANCENot enough credit in the account
MOCK_CAMPAIGN_NOT_ALLOWEDProvisioning not allowed for mock campaigns
TFN_NOT_ALLOWEDToll free numbers not allowed
INVALID_NNIDInvalid NNID

Example Callback Payload

{
  "resourceType": "IMPORTED_NUMBER",
  "eventType": "LINK_TO_10DLC_CAMPAIGN",
  "eventId": "abcd1234efghijklmnop567890",
  "timestamp": "2023-06-06T07:45:27.785357Z",
  "projectId": "abcd12ef-ab12-ab12-bc34-abcdef123456",
  "resourceId": "+12345612345",
  "status": "FAILED",
  "failureCode": "CAMPAIGN_NOT_AVAILABLE"
}

HMAC Signature Verification

Callbacks include an X-Sinch-Signature header. To verify:

  1. Configure your HMAC secret via PATCH /v1/projects/{projectId}/callbackConfiguration
  2. Compute HMAC-SHA1 of the raw callback request body using your secret
  3. Compare against the X-Sinch-Signature header value

skills

sinch-imported-numbers-hosting-orders

references

callbacks.md

SKILL.md

README.md

tile.json