Update Business Profile

{
  "businessProfile": {
    "id": "664a1b2c3d4e5f6071829300",
    "taxIdLast4": "4321",
    "verificationStatus": "unverified",
    "updatedAt": "2026-07-26T13:00:00Z"
  }
}

PATCH

business-profiles

{profile_id}

{
  "businessProfile": {
    "id": "664a1b2c3d4e5f6071829300",
    "taxIdLast4": "4321",
    "verificationStatus": "unverified",
    "updatedAt": "2026-07-26T13:00:00Z"
  }
}

Updates fields on a business profile. This is the correction and resubmission path: changing an identity field (companyLegalName, taxId, or addressCountry) on a verified profile releases verification (back to unverified) and re-submits KYB automatically. Editing only non-identity fields (e.g. industry, websiteUrl) leaves verification untouched. A profile in a non-verified state (e.g. rejected) only releases when it carries every field KYB submission needs — companyLegalName, taxId, addressCountry, businessContactFirstName, businessContactLastName. Editing an identity field while any of those is missing leaves the current status in place, so a rejected profile keeps its account lock until it is whole. Re-submission is asynchronous, so verificationStatus in this response is the post-release value (unverified), not pending.

Requires a live key. A locked profile (three failed attempts) can’t be edited — contact support.

Path Parameters

string

required

The id of the business profile.

Body Parameters

Any subset of the create fields. Send at least one.

Response Fields

object

The updated profile. verificationStatus reflects any release/resubmission triggered by the edit.

Examples

cURL

curl -X PATCH "https://api.tracklysms.com/api/v2/business-profiles/664a1b2c3d4e5f6071829300" \
  -H "X-Api-Key: trk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "taxId": "98-7654321" }'

Python

import requests

resp = requests.patch(
    "https://api.tracklysms.com/api/v2/business-profiles/664a1b2c3d4e5f6071829300",
    headers={"X-Api-Key": "trk_your_api_key_here"},
    json={"taxId": "98-7654321"},
)
print(resp.json()["businessProfile"]["verificationStatus"])  # -> "unverified" (released; KYB re-submits asynchronously)

{
  "businessProfile": {
    "id": "664a1b2c3d4e5f6071829300",
    "taxIdLast4": "4321",
    "verificationStatus": "unverified",
    "updatedAt": "2026-07-26T13:00:00Z"
  }
}

Error Codes

HTTP Status	Error Code	Description
400	`empty_update`	No updatable fields were provided.
403	`sandbox_read_only`	Sandbox keys cannot edit profiles.
403	`compliance_profile_locked`	The profile is locked (three strikes).
403	`compliance_profile_strike_limit` / `account_locked`	Resubmission is blocked by strikes or an account lock.
404	`not_found`	No profile with that id on your account.
422	`validation_failed`	An identity field is invalid — see `fields`. For CA profiles, `identifierType` is required; any PATCH on a CA profile without it will fail with code `identifier_type_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)

Update Business Profile

Path Parameters

Body Parameters

Response Fields

Examples

Error Codes

Next Steps

Submission history

Status webhooks

​Path Parameters

​Body Parameters

​Response Fields

​Examples

​Error Codes

​Next Steps

Submission history

Status webhooks

Path Parameters

Body Parameters

Response Fields

Examples

Error Codes

Next Steps