Create Business Profile

{
  "businessProfile": {
    "id": "664a1b2c3d4e5f6071829300",
    "name": "Acme Retail Profile",
    "companyLegalName": "Acme Incorporated",
    "taxIdLast4": "6789",
    "addressCountry": "US",
    "verificationStatus": "unverified",
    "supportingDocumentCount": 0,
    "createdAt": "2026-07-26T12:00:00Z"
  }
}

{
  "error": "validation_failed",
  "fields": [
    { "field": "taxId", "code": "compliance_tax_id_format", "message": "taxId format is invalid for US" }
  ]
}

POST

business-profiles

{
  "businessProfile": {
    "id": "664a1b2c3d4e5f6071829300",
    "name": "Acme Retail Profile",
    "companyLegalName": "Acme Incorporated",
    "taxIdLast4": "6789",
    "addressCountry": "US",
    "verificationStatus": "unverified",
    "supportingDocumentCount": 0,
    "createdAt": "2026-07-26T12:00:00Z"
  }
}

{
  "error": "validation_failed",
  "fields": [
    { "field": "taxId", "code": "compliance_tax_id_format", "message": "taxId format is invalid for US" }
  ]
}

Creates a business profile on your account. Only name is required — you can create a draft and fill it in later. When the profile carries a complete identity (companyLegalName, taxId, addressCountry, businessContactFirstName, businessContactLastName), KYB verification starts automatically. Submission is asynchronous, so this response still reports verificationStatus: "unverified"; it moves to pending shortly after, once the submission is accepted. Poll Get Business Profile or subscribe to the business_profile.* webhooks rather than reading the outcome off the create response.

Requires a live key. This endpoint is idempotent: send an Idempotency-Key header to make retries safe.

Body Parameters

string

required

Profile label (distinct from the brand name — an account can hold several profiles). Max 100 characters.

string

Registered legal entity name, as it appears on IRS/registry records. For US TIN match, the sanitized name must be ≤ 40 characters.

string

EIN / TIN. Validated against addressCountry’s format; stored in its canonical form.

string

Type of value in taxId (e.g. ein, cbn, neq, provincial_number, registration_number). Auto-defaulted for countries with exactly one legal value; CA requires an explicit choice.

string

ISO 3166-1 country (alpha-2, alpha-3, or full name). Must be a supported jurisdiction.

string

Authorized contact first name (required by the carrier registry at verification).

string

Authorized contact last name.

string

Street.

string

City.

string

State/region (coerced to a 2-letter code where applicable).

string

Postal code.

string

Brand name.

string

Business website URL.

string

Business contact email.

string

Industry / vertical.

Response Fields

object

The created profile (see Get Business Profile). verificationStatus is unverified in this response even when KYB was auto-submitted — the move to pending happens asynchronously. taxIdLast4 is returned in place of the full tax id.

Examples

cURL

curl -X POST "https://api.tracklysms.com/api/v2/business-profiles" \
  -H "X-Api-Key: trk_your_api_key_here" \
  -H "Idempotency-Key: create-acme-profile-1" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Retail Profile",
    "companyLegalName": "Acme Incorporated",
    "taxId": "12-3456789",
    "addressCountry": "US",
    "businessContactFirstName": "Jane",
    "businessContactLastName": "Doe"
  }'

Python

import requests

resp = requests.post(
    "https://api.tracklysms.com/api/v2/business-profiles",
    headers={"X-Api-Key": "trk_your_api_key_here", "Idempotency-Key": "create-acme-profile-1"},
    json={
        "name": "Acme Retail Profile",
        "companyLegalName": "Acme Incorporated",
        "taxId": "12-3456789",
        "addressCountry": "US",
        "businessContactFirstName": "Jane",
        "businessContactLastName": "Doe",
    },
)
print(resp.json()["businessProfile"]["verificationStatus"])

{
  "businessProfile": {
    "id": "664a1b2c3d4e5f6071829300",
    "name": "Acme Retail Profile",
    "companyLegalName": "Acme Incorporated",
    "taxIdLast4": "6789",
    "addressCountry": "US",
    "verificationStatus": "unverified",
    "supportingDocumentCount": 0,
    "createdAt": "2026-07-26T12:00:00Z"
  }
}

{
  "error": "validation_failed",
  "fields": [
    { "field": "taxId", "code": "compliance_tax_id_format", "message": "taxId format is invalid for US" }
  ]
}

Error Codes

HTTP Status	Error Code	Description
400	`missing_name`	`name` is required.
403	`sandbox_read_only`	Sandbox keys cannot create profiles — use a live key.
403	`account_locked` / `daily_cap_hit`	A rejected/locked profile on the account, or the daily verification cap, blocks new profiles.
422	`validation_failed`	One or more identity fields are invalid — see `fields`. For CA profiles, `identifierType` is required.

API Reference

V2 API Reference

Partner Accounts (v2)

Messages (v2)

Contacts (v2)

Lists (v2)

Number Requests (v2)

Business Profiles (v2)

Creatives (v2)

Audiences (v2)

Offers (v2)

Schedules (v2)

Revenue (v2)

Usage & Billing (v2)

Data Import (v2)

Links (v2)

Clicks (v2)

Webhooks (v2)

Phone Validation (v1)

API Reference (v1 - Deprecated)

Create Business Profile

Body Parameters

Response Fields

Examples

Error Codes

Next Steps

Validate first

Submission history

​Body Parameters

​Response Fields

​Examples

​Error Codes

​Next Steps

Validate first

Submission history

Body Parameters

Response Fields

Examples

Error Codes

Next Steps