Skip to content
Beauty RouterBeauty Router Docs

company.verification_updated

View as Markdown
POST

The company’s verification status changed, or a change made after verification was approved or declined.

Parameters

Section titled “Parameters”

Header Parameters

Section titled “Header Parameters”
Beauty-Router-Signature
required
string

t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>" with your webhook secret>. While several secrets are live, the header has one v1 per live secret, and you accept the event if any v1 matches. Reject a request when t is more than 5 minutes old or more than 5 minutes in the future. See Webhooks.

Example 

t=1793200437,v1=5f2b8c0e4d6a7b1c9e3f0a2d4b6c8e1f3a5b7d9c0e2f4a6b8d1c3e5f7a9b0c2d

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
id
required

The event ID. Skip an event you already handled.

string
createdAt
required
string format: date-time
type
required
string
Allowed value: company.verification_updated
data
required
object
companyId
required
string
verificationStatus
required

unverified: not submitted yet. in_review: Beauty Router is reviewing the company. prequalified: the initial check passed, and the detailed verification is still pending. The company can order, its orders wait until that verification ends, and no charge happens until then. verified: the company passed the review. declined: the company did not pass the review.

string
Allowed values: unverified in_review prequalified verified declined
pendingChanges
required
One of:

New values of an in_review, prequalified, or verified company that wait for review. null when no change waits for review.

object
businessType

salon for a salon or spa, professional for an individual licensed professional, store for a beauty supply store. Beauty Router does not support stores yet, so verification for a store always fails.

string
Allowed values: salon professional store
displayName
string
legalName
string
ein
string
/^[0-9]{9}$/

Examples

ExampleCompany verified
{
  "id": "event-2Rb6nMq8Wc",
  "type": "company.verification_updated",
  "createdAt": "2026-10-27T13:20:11Z",
  "data": {
    "companyId": "loc-7Hk2pQx9Lm",
    "verificationStatus": "verified",
    "pendingChanges": null
  }
}

Responses

Section titled “Responses”

2XX

Section titled “2XX”

Respond with a 2xx status within 10 seconds. Otherwise Beauty Router retries with backoff for up to 24 hours. Delivery is at least once, so skip an event id you already handled.