Resubmit a toll-free verification

POST/api/v1/sms/numbers/{id}/resubmit

POST /sms/numbers/{id}/resubmit

curl -X POST 'https://www.unitpost.com/api/v1/sms/numbers/sms_123/resubmit' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'User-Agent: my-app/1.0' \
  -H 'Content-Type: application/json' \
  -d '{ }'

Response · 200

{
  "object": "sms_number_resubmission",
  "number_id": "number_123",
  "status": "resubmitted",
  "resubmitted": true
}

Resubmit a toll-free number's verification carriers sent back (action_required; feedback on List SMS numbers), or that failed before review. The form is composed again from the number's brand and a messaging program (default: the one it was registered from), so fix what carriers flagged there first. The evidence on file is reused unless opt_in_evidence_file_id replaces it; when carriers flagged the evidence, a new file (or reuse_opt_in_evidence) is required. Free while the number's monthly fee is committed, else 409 quote_required. Flagged values resent unchanged are refused (flagged_fields_unchanged) unless acknowledge_unchanged. Takes an Idempotency-Key. Requires the sms:manage capability.

Parameters2 fields

Field	Type	Description
`id`required	string · path	—
`Idempotency-Key`	string · header	Any unique string (1–256 characters, e.g. a UUID). Retrying with the same key and the same body within 24 hours returns the first result instead of sending again; the same key with a different body is `409 invalid_idempotent_request`, and one still in flight is `409 concurrent_idempotent_requests`.

Request body6 fields

Field	Type	Description
`messaging_program_id`	string	The messaging program (`prog_…`) the corrected use case, samples and opt-in come from; fix what carriers flagged there (or on the brand) first. Defaults to the program the number was registered from.
`opt_in_evidence_file_id`	string	New opt-in evidence (POST /files, purpose `sms_opt_in_evidence`). Required when carriers flagged the evidence, unless `reuse_opt_in_evidence`.
`reuse_opt_in_evidence`	boolean	Send the evidence on file again although carriers flagged it (it was fixed where it lives, e.g. the page it shows changed).
`business_registration_document_file_id`	string	A new business registration document (POST /files, purpose `sms_document`, up to 2 MB): required when carriers flagged it.
`consent_source_url`	string	The public https page where people opt in.
`acknowledge_unchanged`	boolean	Resubmit fields carriers flagged unchanged, because the cause was fixed outside Unitpost. Without it they're refused (`flagged_fields_unchanged`).

Response · 200 fields4 fields

Field	Type	Description
`object`required	string	—
`number_id`required	string	—
`status`required	string	The verification went back to carriers; the number reads `pending` on GET /sms/numbers until they answer.
`resubmitted`required	boolean	—

200400401403404409413415422429502

Resubmit a toll-free verification

Resubmit a toll-free verification

Search docs and guides