stripe.tax_ids.create_tax_id

Attach a tax ID (CNPJ/CPF and others) to a Stripe customer

Attach a tax ID to a customer so it appears on their invoices.

For Brazil the two types that matter are br_cnpj (company) and br_cpf (individual) — without one, an invoice to a Brazilian business is not usable for their accounting.

Acts on the CUSTOMER'S OWN Stripe account, authenticated via the org-scoped Stripe connection selected by cloud_connection_uuid.

Inputs:

• cloud_connection_uuid: Org-scoped Stripe connection (customer's own account).
• customer_id: Stripe customer ID (cus_...).
• tax_id_type: Stripe tax ID type, e.g. br_cnpj, br_cpf, eu_vat.
• value: The tax ID itself, e.g. the CNPJ number.

Outputs (terminal state_data):

• tax_id: str
• tax_id_type: str
• value: str
• customer_id: str
• verification_status: str

Connection required: cloud_connection_uuid — the organization's own Stripe account credentials; there is no platform-key fallback.

Overview

Property	Value
Workflow type	Atomic
Library	App-stripe
Version	1.0

Input Schema

Field	Type	Required	Default	Description
cloud_connection_uuid	uuid	Yes	—	Org-scoped Stripe connection (customer's own account)
customer_id	string	Yes	—	Stripe customer ID (cus_...)
tax_id_type	string	Yes	—	Stripe tax ID type, e.g. br_cnpj, br_cpf, eu_vat
value	string	Yes	—	The tax ID itself, e.g. the CNPJ number

Output Schema

Field	Type	Required	Default	Description
tax_id	string	No	—	—
tax_id_type	string	No	—	—
value	string	No	—	—
customer_id	string	No	—	—
verification_status	string	No	—	—
cloud_connection_uuid	uuid	No	—	—
failure_reason	string	No	—	—
failure_type	string	No	—	—
failed_action	string	No	—	—
failed_at_state	string	No	—	—
failed_step	string	No	—	—
error	string	No	—	—
error_type	string	No	—	—
failed_layer	integer	No	—	—

States

State	Initial	Terminal	Success	Auto-advance	Description
pending	Yes	No	—	execute	—
completed	No	Yes	Yes	—	—
failed	No	Yes	No	—	—

State Diagram

Transitions

From	Action	To	Description
pending	execute	completed	—
* (any state)	fail	failed	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "stripe.tax_ids.create_tax_id",
  "initial_data": {
    "cloud_connection_uuid": "value",
    "customer_id": "value",
    "tax_id_type": "value",
    "value": "value"
  }
}