Skip to main content
POST
https://app.usatimbre.com
/
api
/
timbre
/
create-profile
curl -X POST "https://app.usatimbre.com/api/timbre/create-profile" \
  -H "Authorization: Bearer tmb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "tax_info": {
      "tax_id": "XAXX010101000",
      "taxpayer": "Juan Pérez",
      "street": "Calle Principal 123",
      "ext_num": "123",
      "neighborhood": "Centro",
      "city": "Ciudad de México",
      "state": "CDMX",
      "country": "México",
      "postal_code": "12345",
      "fiscal_regimen": "601",
      "cfdi_use": "G03"
    },
    "email": "[email protected]",
    "phone_number": "+525512345678"
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Juan Pérez",
  "email": "[email protected]",
  "phone_number": "+525512345678",
  "tax_id": "XAXX010101000",
  "org_id": "org_123456",
  "created_at": "2024-01-21T10:00:00Z"
}

​
Overview

Create a new profile within your organization, including complete tax information for invoice generation.

​
Request Body

​
tax_info
object
required
Tax information object
​
email
string
Email address for the profile
​
phone_number
string
Phone number with country code (e.g., +525512345678)

​
Response

Returns the created profile object.
​
id
string
Unique profile identifier (UUID)
​
name
string
Profile name (derived from taxpayer)
​
email
string
Email address
​
tax_id
string
RFC
​
org_id
string
Organization ID
​
created_at
string
ISO 8601 timestamp
curl -X POST "https://app.usatimbre.com/api/timbre/create-profile" \
  -H "Authorization: Bearer tmb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "tax_info": {
      "tax_id": "XAXX010101000",
      "taxpayer": "Juan Pérez",
      "street": "Calle Principal 123",
      "ext_num": "123",
      "neighborhood": "Centro",
      "city": "Ciudad de México",
      "state": "CDMX",
      "country": "México",
      "postal_code": "12345",
      "fiscal_regimen": "601",
      "cfdi_use": "G03"
    },
    "email": "[email protected]",
    "phone_number": "+525512345678"
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Juan Pérez",
  "email": "[email protected]",
  "phone_number": "+525512345678",
  "tax_id": "XAXX010101000",
  "org_id": "org_123456",
  "created_at": "2024-01-21T10:00:00Z"
}