DRUO
Get started
Platforms

Create Profile

POSThttps://api.druo.com/profiles/create

Creates a new business profile.

Creates a Profile object within a platform program. This initiates the onboarding or creation flow for a merchant profile, defining its default currency, legal representatives, and banking information.

Request body

platform_program_idstringRequired

The ID of the Platform Program the new profile will join.

typestringRequired

The type of profile to create.

namestringRequired

The public name of the business.

local_idstringRequired

The tax or identity number of the business, as issued in its country.

local_id_typestringRequired

The type of the identifier sent in local_id.

primary_categorystringRequired

The main category of the business.

secondary_categorystringoptional

A more specific category within the primary_category.

websitestringRequired

The business website. Must be a valid URL.

default_currencystringRequired

The default currency of the profile, in ISO 4217 format.

sizestringRequired

The size of the business, represented by its number of employees.

The main person who represents the business.

The first name of the primary representative.

The last name of the primary representative.

The job title of the primary representative.

The email address of the primary representative.

The phone number of the representative.

The international dialing code, without the + sign.

The phone number, without the country code.

deposit_accountobjectoptional

The bank account where the profile receives its deposits. Some programs require it; if yours does and it is missing, the request is rejected.

The UUID of the financial institution that holds the account.

The account's number.

The subtype of account. Provides further detail about the type of account.

registered_addressobjectRequired

The legal address of the business.

The name of the person the correspondence is addressed to.

The organization the correspondence is addressed to.

Street name and number.

Apartment, suite or unit.

Additional address information.

The city or town.

The state, province or region.

The code of the state, province or region.

The second-level administrative division, such as a county.

The postal or ZIP code of the registered address.

The country, as an ISO 3166 alpha-3 code.

The contact details shown publicly for the business.

The support email address.

The support phone number.

The international dialing code, without the + sign.

The phone number, without the country code.

attestationsobjectoptional

Proof that the business accepted DRUO's legal agreements.

Acceptance of the Terms of Service.

Whether the business accepted the Terms of Service.

When the Terms of Service were accepted, in ISO 8601 UTC format.

The IP address from which the Terms of Service were accepted.

The user agent of the browser or app used to accept the Terms of Service.

The URL of the page where the Terms of Service were accepted.

Acceptance of the Privacy Policy.

Whether the business accepted the Privacy Policy.

When the Privacy Policy was accepted, in ISO 8601 UTC format.

The IP address from which the Privacy Policy was accepted.

The user agent of the browser or app used to accept the Privacy Policy.

The URL of the page where the Privacy Policy was accepted.

Response

uuidstringoptional

The Profile's UUID.

Example: pro_f4ac8520-3de3-40d6-9059-a5da34f34123
codestringoptional

The Profile's unique code.

Example: PRLX6CATF123
global_statusstringoptional

The status of the profile.

Possible values:CREATEDWAITLISTEDONBOARDINGREJECTEDACTIVERESTRICTEDSUSPENDEDTERMINATEDDEACTIVATEDDELETED
Example: CREATED
platform_program_idstringoptional

The ID of the Platform Program the profile belongs to.

Example: plp_8555fd61-d666-480f-bc95-4d1d752fb000
typestringoptional

The type of the Profile.

Example: MERCHANT
namestringoptional

The public name of the business.

Example: Cafe Novo
websitestringoptional

The business website.

Example: https://cafenovo.com
countrystringoptional

The country of the business, as an ISO 3166 alpha-3 code.

Example: USA
primary_categorystringoptional

The main category of the business.

Example: FINANCIAL_AND_INSURANCE_SERVICES
secondary_categorystringoptional

The specific category within the primary_category.

Example: INSURANCE
default_currencystringoptional

The default currency of the profile, in ISO 4217 format.

Example: USD
environmentsarrayoptional

The environments in which the profile operates.

Example: [{"merchant_id": "mer_03c9ecb2-5d67-47d0-88e5-0728ff2f1234", "merchant_code": "MF3A7TJ1234", "environment": "PRODUCTION"}]
creation_sourcestringoptional

The creation source of the profile.

Example: MERCHANT_API
date_created_gmtstringoptional

The date and time the profile was created.

Example: 2026-11-10T21:34:23.081Z
date_updated_gmtstringoptional

The date and time the profile was last updated.

Example: 2026-11-10T21:34:23.081Z
NextGETGet Profile