Service Provider

Create CRB

Create a new CRB and associate with service provider.

There are two supported onboarding workflows:

  1. Provide POS Credentials Up Front (pos_info)

    • Use when the CRB has already provided their POS credentials.
    • Include the pos_info object in your request.
    • Inviting users is optional.
  2. Invite the CRB for In-App Onboarding

    • Use when you don't have the CRB's POS credentials yet.
    • Do NOT include pos_info.
    • MUST include at least one user in the users array to send an invite.

Note: You MUST provide either pos_info OR users with at least one entry. You may also provide both.


Validation Rules

If pos_info is provided:

  • Org business_type must match pos_type (e.g. wholesale org must use a wholesale POS like "Dutchie Wholesale").
  • Credentials must be valid; a test POS call is made.
  • If the POS requires a location_id, it must be valid.
    • If missing or invalid, a validation error is returned with valid options.
  • The org must not already be connected to your account.

If pos_info is NOT provided:

  • At least one user must be included in the users array.

Testing Scenarios (Sandbox Only)

  1. Provide pos_info with a wholesale POS, but business_type = "retail" → Expect validation error.
  2. Provide pos_info with:
    • pos_type = "Greenbits"
    • username = "testing"
    • password = "invalid_testing" → Simulates invalid credentials
    • password = "testing" → Simulates valid credentials
  3. Leave location_id empty → Simulates missing required location, returns available options.
  4. Set location_id = "invalidLocation" → Simulates invalid location, returns available options.
  5. Set location_id = "testing" → Simulates successful connection (no actual POS connection made).
post/service-providers/{sp_id}/crbs

Request

Path parameters

sp_idstring required

Service Provider Id

Request body

Response

Ok

idstring uuid required
namestring required

Organization name

street_addressstring required

Street Address

street_address_2string nullable required

Street Address 2

citystring required

City

einstring required

EIN (Employer Identification Number) - ##-#######

phone_numberstring required

Phone Number - (###) ####-####

postal_codestring required

Postal Code

countrystring nullable required

Country

state'AL' | 'AK' | 'AZ' | 'AR' | 'AS' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FM' | 'FL' | 'GA' | 'GU' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MH' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'MP' | 'OH' | 'OK' | 'OR' | 'PW' | 'PA' | 'PR' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UM' | 'UT' | 'VT' | 'VA' | 'VI' | 'WA' | 'WV' | 'WI' | 'WY' | 'AA' | 'AE' | 'AP' required

Enumeration of all of the United States

websitestring required

Website

timezone'America/New_York' | 'America/Detroit' | 'America/Kentucky/Louisville' | 'America/Kentucky/Monticello' | 'America/Indiana/Indianapolis' | 'America/Indiana/Vincennes' | 'America/Indiana/Winamac' | 'America/Indiana/Marengo' | 'America/Indiana/Petersburg' | 'America/Indiana/Vevay' | 'America/Chicago' | 'America/Indiana/Tell_City' | 'America/Indiana/Knox' | 'America/Menominee' | 'America/North_Dakota/Center' | 'America/North_Dakota/New_Salem' | 'America/North_Dakota/Beulah' | 'America/Denver' | 'America/Boise' | 'America/Phoenix' | 'America/Los_Angeles' | 'America/Anchorage' | 'America/Juneau' | 'America/Puerto_Rico' | 'America/Sitka' | 'America/St_Thomas' | 'America/Metlakatla' | 'America/Yakutat' | 'America/Nome' | 'America/Adak' | 'Pacific/Honolulu' | 'Pacific/Guam' | 'Pacific/Kosrae' | 'Pacific/Midway' | 'Pacific/Pago_Pago' | 'Pacific/Palau' | 'Pacific/Kwajalein' | 'Pacific/Saipan' required
mailing_street_addressstring nullable required

Mailing Street Address

mailing_citystring required

City

mailing_state'AL' | 'AK' | 'AZ' | 'AR' | 'AS' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FM' | 'FL' | 'GA' | 'GU' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MH' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'MP' | 'OH' | 'OK' | 'OR' | 'PW' | 'PA' | 'PR' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UM' | 'UT' | 'VT' | 'VA' | 'VI' | 'WA' | 'WV' | 'WI' | 'WY' | 'AA' | 'AE' | 'AP' required

Enumeration of all of the United States

mailing_postal_codestring required

Postal Code

established_datestring required
ftEmployeesinteger nullable required
ptEmployeesinteger nullable required
entityType'sole' | 'partnership' | 'corporation' | 'llc' required
dbastring nullable required

Doing Business As

monthlySalesstring nullable required

Estimated amouunt of monthly sales

monthlyCustomersinteger nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.