MentionBird
compliance_submissions_create
Files a country's registration answers, all of them in one call, and there is no draft to build up first. What to send is `compliance_requirements`'s `fields`, item by item; a country it does not cover is refused rather than accepted empty. Filing twice for the same registration returns 409, so correct a refused answer with `compliance_submissions_resupply` instead. The answers are a legal representation about the business, relayed onward to a carrier or a regulator under the name of the business they describe, so confirm them with the user before this call rather than filing on your own.
Remote bird/mcp
Remote (network-hosted)
Other tools also called compliance_submissions_create?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"answers": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"required": [
"key"
],
"properties": {
"key": {
"type": "string"
},
"value": {
"type": [
"null",
"string"
]
},
"values": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"attachment_id": {
"type": [
"null",
"string"
]
},
"attachment_ids": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"description": "Every answer at once. Because submissions have no multi-call draft, send a complete set. Anything missing or malformed comes back named. A requirement the named party already answers may be left out; one you send anyway wins over what the party holds."
},
"program": {
"type": "string",
"description": "The registration program a country runs. Available programs depend on the registered resource. An SMS sender registers under an authority regime (alpha or numeric). A phone number proves ownership under its number type (mobile, local, national, short_code, short_code_fteu, or toll_free), matching the values of NumberType. A value is therefore only meaningful alongside the subject it describes. More are added as coverage grows, so treat this as an open set rather than a fixed list."
},
"identity": {
"type": [
"null",
"object"
],
"properties": {
"name": {
"type": [
"null",
"string"
]
}
},
"description": "Registers this on behalf of a party you have not stored yet, creating it as part of the submission so you do not need a separate call. Exclusive with identity_id. Each time you send this you get a new party. Business details approved for one are reused only by registrations naming the same party, so send this once and use the identity_id from the response for the countries that follow.",
"additionalProperties": false
},
"subject_id": {
"type": "string",
"description": "What is being registered. For sms_sender this is the scr_ id returned when you register a sender for a country. For number it is the nda_ id of a dedicated number you hold, as returned by GET /v1/numbers. A shared short code (nal_) is not accepted: it is shared, so its ownership paperwork is not yours to file."
},
"identity_id": {
"type": "string",
"description": "An existing party this registration is for. It fills in the business details you left out from what that party already holds, and an answer approved here is written back onto it for next time. Send this or identity, never both. An id belonging to another organization is rejected; nothing is created here."
},
"country_code": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code."
},
"subject_kind": {
"type": "string",
"examples": [
"sms_sender",
"number"
],
"description": "What is being registered. sms_sender is a sender registered to send to one country. number is a phone number you hold that needs ownership paperwork before it can carry traffic."
},
"idempotency_key": {
"type": "string",
"description": "Client-supplied deduplication key; a retry with the same key replays the original result instead of acting twice."
}
}
}