Create the brand
Use POST /brands for direct creation. This endpoint always creates a sole proprietor. Required fields are display_name, email, phone, first_name, last_name, mobile_phone, street, city, state and postal_code. Phone numbers must use E.164 format, such as +15555550123. No EIN is required.
Complete SMS verification
- Create the brand and save
data.brand.ref. Send a uniqueIdempotency-Keyheader for this customer registration and reuse it only for retries of that same request. - Call
POST /brands/{ref}/otp. It registers the brand if needed and sends the mobile number a request to reply YES. - Tell the recipient to reply YES to the SMS. Do not build a PIN-entry screen for this flow.
- Poll
GET /brands/{ref}/otpuntildata.otp_statusisverified. The default resend cooldown is 60 seconds.
POST /brands/{ref}/otp/verify with an empty body can also poll for the YES reply. It returns 409 until verified. Its optional code field is a legacy fallback, not part of the normal YES flow.