NetBird

sms_tfn_verifications_update

Fills in the business and messaging details of a verification that is still editable: a draft, one the carrier sent back asking for more, or a rejected one while its resubmission window is open. Send only the fields that change; anything omitted is left as it was. A submitted, under-review, or approved verification is locked.

Remote bird/mcp

Remote (network-hosted)

Other tools also called sms_tfn_verifications_update? See providers with this name

Input Schema


            {
  "type": "object",
  "properties": {
    "age_gated": {
      "type": [
        "null",
        "boolean"
      ],
      "description": "Whether the messaging content is age-gated."
    },
    "contact_email": {
      "type": "string",
      "description": "Email address of the business contact."
    },
    "contact_phone": {
      "type": "string",
      "description": "Phone number of the business contact, in E.164 format."
    },
    "help_response": {
      "type": "string",
      "description": "The HELP reply you are declaring to the carrier, reviewed as part of verification. It does not set what is actually sent: configure that under your SMS keyword rules, and keep the two consistent so what goes out matches what was approved."
    },
    "message_sample": {
      "type": "string",
      "description": "A representative example of messages sent from the number."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Client-supplied deduplication key; a retry with the same key replays the original result instead of acting twice."
    },
    "verification_id": {
      "type": "string",
      "description": "ID of the toll-free verification (tfv_ prefix), as returned by the verification list."
    },
    "business_website": {
      "type": "string",
      "description": "Public website of the business."
    },
    "contact_last_name": {
      "type": "string",
      "description": "Last name of the business contact."
    },
    "legal_entity_name": {
      "type": "string",
      "description": "Legal name of the business being verified."
    },
    "use_case_category": {
      "type": "string",
      "description": "The messaging use case for this number."
    },
    "contact_first_name": {
      "type": "string",
      "description": "First name of the business contact."
    },
    "opt_in_description": {
      "type": "string",
      "description": "How recipients opt in to receive messages."
    },
    "privacy_policy_url": {
      "type": "string",
      "description": "Publicly reachable URL of the privacy policy that applies to recipients of these messages."
    },
    "business_entity_type": {
      "type": "string",
      "examples": [
        "sole_proprietor",
        "private_profit",
        "public_profit",
        "non_profit",
        "government"
      ],
      "description": "Legal structure of the business being verified. Spelled the same as 10DLC's entity type, which names the same five structures; the two stay separate enums because what each authority accepts is its own to change."
    },
    "use_case_description": {
      "type": "string",
      "description": "A short description of how the number is used."
    },
    "business_address_city": {
      "type": "string",
      "description": "City of the business address."
    },
    "business_address_line1": {
      "type": "string",
      "description": "First line of the business address."
    },
    "business_address_line2": {
      "type": "string",
      "description": "Second line of the business address."
    },
    "business_address_state": {
      "type": "string",
      "description": "State or province of the business address."
    },
    "business_address_country": {
      "type": "string",
      "description": "Country of the business address, as an ISO 3166-1 alpha-2 code. Accepted in either case and stored uppercase."
    },
    "terms_and_conditions_url": {
      "type": "string",
      "description": "Publicly reachable URL of the terms and conditions that apply to recipients of these messages."
    },
    "business_registration_type": {
      "type": "string",
      "examples": [
        "ein",
        "cbn",
        "neq",
        "provincial_number",
        "crn",
        "vat",
        "acn",
        "abn",
        "brn",
        "siren",
        "siret",
        "nzbn",
        "ust_idnr",
        "cif",
        "nif",
        "cnpj",
        "uid",
        "other"
      ],
      "description": "Kind of government-issued business registration identifier supplied in business_registration_number for a toll-free verification: - ein: US Employer Identification Number. - cbn: Canada Business Number. - neq: Numéro d'entreprise du Québec, Quebec's provincial enterprise number. - provincial_number: A Canadian provincial registration number other than neq. - crn: Company Registration Number, issued by a national companies registry (for example, UK Companies House). - vat: Value Added Tax identification number. - acn: Australian Company Number. - abn: Australian Business Number. - brn: Business Registration Number, issued by a national business registry. - siren: French business identification number. - siret: French business establishment identification number (a siren plus a location suffix). - nzbn: New Zealand Business Number. - ust_idnr: Umsatzsteuer-Identifikationsnummer, the Austrian or German vat identification number. - cif: Certificado de Identificación Fiscal, the Spanish tax ID for legal entities. - nif: Número de Identificación Fiscal, a Spanish or Portuguese tax identification number. - cnpj: Cadastro Nacional da Pessoa Jurídica, the Brazilian business tax ID. - uid: Unternehmens-Identifikationsnummer, the Swiss or Austrian business identification number. - other: A government-issued business identifier not listed above."
    },
    "business_address_postal_code": {
      "type": "string",
      "description": "Postal or ZIP code of the business address."
    },
    "business_registration_number": {
      "type": "string",
      "description": "Government-issued business registration or tax identifier."
    },
    "monthly_volume_estimate_tier": {
      "type": "string",
      "examples": [
        "up_to_10",
        "up_to_100",
        "up_to_1k",
        "up_to_10k",
        "up_to_100k",
        "up_to_250k",
        "up_to_500k",
        "up_to_750k",
        "up_to_1m",
        "up_to_5m",
        "above_5m"
      ],
      "description": "Estimated messages a month, as the band the carrier reviews against. One band per value the carrier accepts, so nothing is lost in either direction. The top band is above_5m rather than a ten-million ceiling on purpose: the band below it is up_to_5m, so naming this one for ten million would leave five to ten million with no band that claims it."
    },
    "opt_in_confirmation_response": {
      "type": "string",
      "description": "The opt-in confirmation you are declaring to the carrier, reviewed as part of verification. It does not set what is actually sent."
    },
    "business_registration_country": {
      "type": "string",
      "description": "Country that issued the business registration, as an ISO 3166-1 alpha-2 code such as US. Accepted in either case and stored uppercase."
    },
    "opt_in_evidence_attachment_ids": {
      "type": [
        "null",
        "array"
      ],
      "items": {
        "type": "string"
      },
      "description": "IDs of uploaded screenshots evidencing the opt-in workflow. Upload each file with POST /v1/compliance/attachments first, then list the returned IDs here."
    }
  }
}
          

Provider

NetBird →