Create Business - Ingo Payments Developer Hub

POST

business

create

Create a business entity

curl --request POST \
  --url https://api.sdev.banking.ingopayments.tech/api/v4/business/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "api_key": "YOUR_API_KEY",
  "name": "Judo INC60",
  "user_id": "user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef",
  "email": "johndoe6@example.com",
  "phone_number": "+15555551234",
  "support_email": "support@example.com",
  "support_phone_number": "+15555555678",
  "business_address": "100 Innovation Way",
  "business_address_2": "Suite 200",
  "naics_code": "541611",
  "business_type": "LLC",
  "country": "US",
  "ein": "12-3456789",
  "business_industry": "Consulting",
  "incorporated_date": "2020-01-01",
  "incorporated_state": "CA",
  "business_description": "A consulting firm offering expert advice.",
  "zipcode": "00000",
  "city": "Los Angeles",
  "state": "CA",
  "business_name": "Doe60 LLC",
  "business_email": "info@example.com",
  "business_phone": "+15555559876",
  "business_rep_name": "Jane Smith",
  "business_rep_email": "janesmith@example.com",
  "business_rep_job_title": "Business Representative",
  "business_rep_dob": "1985-05-15",
  "business_rep_address": "100 Innovation Way",
  "business_rep_address_2": "Apt 5B",
  "business_rep_zipcode": "00000",
  "business_rep_city": "Los Angeles",
  "business_rep_phone": "+15555550001",
  "business_rep_country": "US",
  "business_rep_state": "CA",
  "meta_data": [
    {
      "name": "external_ref",
      "value": "merchant-001"
    },
    {
      "name": "source",
      "value": "partner-portal"
    }
  ]
}
'

{
  "status": "success",
  "message": "operation completed",
  "data": {
    "items": [
      {
        "id": "buss-2ef94c60-5a11-4d72-a3c1-5be7fab0123e",
        "uuid": "<string>",
        "user_id": "user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef",
        "name": "Acme Cafe LLC",
        "dba": "<string>",
        "ein": "12-3456789",
        "business_type": "llc",
        "business_industry": "food_service",
        "business_email": "jane.doe@example.com",
        "business_phone_number": "+12125551234",
        "support_email": "jane.doe@example.com",
        "support_phone_number": "+12125551234",
        "address_one": "<string>",
        "city": "<string>",
        "state": "<string>",
        "country": "<string>",
        "postal_code": "<string>",
        "status": "active",
        "kyb_status": "verified",
        "created_at": "2026-04-16T12:34:56.000Z",
        "updated_at": "2026-04-16T12:34:56.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total": 100,
      "sort": "created_at:desc",
      "search": "jane"
    }
  }
}

Authorizations

api_key

string

header

required

Program API key identifying your integration. Pass as the api_key HTTP header (preferred) or as an api_key field in the JSON request body. Required on every request in addition to the HMAC Authorization header.

Body

application/json

user_id

string

required

Identifier of the representative user. Required.

Example:

"user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef"

business_name

string

required

Legal business name.

string<email>

required

Primary email address for the business.

Example:

"jane.doe@example.com"

phone_number

string

required

Phone number in E.164 format.

Example:

"+12125551234"

business_address

string

required

Business onboarding field: business address.

business_industry

string

required

Business onboarding field: business industry.

country

string

required

ISO 3166-1 alpha-2 country code.

state

string

required

ISO 3166-2 two-letter state/region code.

city

string

required

City.

incorporated_date

string

required

Business onboarding field: incorporated date.

incorporated_state

string

required

Business onboarding field: incorporated state.

api_key

string

Program API key. Accepted either in the api_key HTTP header or as this body field.

name

string

Optional display name. Defaults to business_name when omitted.

business_email

string

Business onboarding field: business email.

business_phone

string

Business onboarding field: business phone.

business_phone_number

string

Business onboarding field: business phone number.

support_email

string

Business onboarding field: support email.

support_phone_number

string

Business onboarding field: support phone number.

website

string

Business onboarding field: website.

business_address_2

string

Business onboarding field: business address 2.

naics_code

string

Business onboarding field: naics code.

business_type

string

Business onboarding field: business type.

zipcode

string

5-digit US ZIP code.

business_description

string

Business onboarding field: business description.

ein

string

Business onboarding field: ein.

logo

string

Business onboarding field: logo.

business_logo

string

Business onboarding field: business logo.

ach_engine

string

Business onboarding field: ach engine.

business_rep_name

string

Legal name of the business representative.

business_rep_email

string

Business onboarding field: business rep email.

business_rep_job_title

string

Business onboarding field: business rep job title.

business_rep_dob

string

Business onboarding field: business rep dob.

business_rep_address

string

Business onboarding field: business rep address.

business_rep_address_2

string

Business onboarding field: business rep address 2.

business_rep_zipcode

string

Business onboarding field: business rep zipcode.

business_rep_city

string

Business onboarding field: business rep city.

business_rep_phone

string

Business onboarding field: business rep phone.

business_rep_ssn

string

Business onboarding field: business rep ssn.

business_rep_website

string

Business onboarding field: business rep website.

business_rep_country

string

Business onboarding field: business rep country.

business_rep_state

string

Business onboarding field: business rep state.

delivery_fufilment

string

Business onboarding field: delivery fufilment.

support_address_one

string

Business onboarding field: support address one.

support_address_two

string

Business onboarding field: support address two.

support_country

string

Business onboarding field: support country.

support_city

string

Business onboarding field: support city.

support_zipcode

string

Business onboarding field: support zipcode.

support_state

string

Business onboarding field: support state.

business_proof

string

Business onboarding field: business proof.

personal_id

string

Business onboarding field: personal id.

send_email_notification

string

Business onboarding field: send email notification.

otp

string

Business onboarding field: otp.

security

string

Business onboarding field: security.

meta_data

object[]

List of {name, value} pairs to persist alongside the entity.

Show child attributes

Response

Success.

status

enum<string>

required

Available options:

success

message

string

required

Example:

"operation completed"

data

object

Endpoint-specific payload; shape varies per operation.

Show child attributes

Create User

Verify User (KYC)

Create a business entity

curl --request POST \
  --url https://api.sdev.banking.ingopayments.tech/api/v4/business/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "api_key": "YOUR_API_KEY",
  "name": "Judo INC60",
  "user_id": "user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef",
  "email": "johndoe6@example.com",
  "phone_number": "+15555551234",
  "support_email": "support@example.com",
  "support_phone_number": "+15555555678",
  "business_address": "100 Innovation Way",
  "business_address_2": "Suite 200",
  "naics_code": "541611",
  "business_type": "LLC",
  "country": "US",
  "ein": "12-3456789",
  "business_industry": "Consulting",
  "incorporated_date": "2020-01-01",
  "incorporated_state": "CA",
  "business_description": "A consulting firm offering expert advice.",
  "zipcode": "00000",
  "city": "Los Angeles",
  "state": "CA",
  "business_name": "Doe60 LLC",
  "business_email": "info@example.com",
  "business_phone": "+15555559876",
  "business_rep_name": "Jane Smith",
  "business_rep_email": "janesmith@example.com",
  "business_rep_job_title": "Business Representative",
  "business_rep_dob": "1985-05-15",
  "business_rep_address": "100 Innovation Way",
  "business_rep_address_2": "Apt 5B",
  "business_rep_zipcode": "00000",
  "business_rep_city": "Los Angeles",
  "business_rep_phone": "+15555550001",
  "business_rep_country": "US",
  "business_rep_state": "CA",
  "meta_data": [
    {
      "name": "external_ref",
      "value": "merchant-001"
    },
    {
      "name": "source",
      "value": "partner-portal"
    }
  ]
}
'

{
  "status": "success",
  "message": "operation completed",
  "data": {
    "items": [
      {
        "id": "buss-2ef94c60-5a11-4d72-a3c1-5be7fab0123e",
        "uuid": "<string>",
        "user_id": "user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef",
        "name": "Acme Cafe LLC",
        "dba": "<string>",
        "ein": "12-3456789",
        "business_type": "llc",
        "business_industry": "food_service",
        "business_email": "jane.doe@example.com",
        "business_phone_number": "+12125551234",
        "support_email": "jane.doe@example.com",
        "support_phone_number": "+12125551234",
        "address_one": "<string>",
        "city": "<string>",
        "state": "<string>",
        "country": "<string>",
        "postal_code": "<string>",
        "status": "active",
        "kyb_status": "verified",
        "created_at": "2026-04-16T12:34:56.000Z",
        "updated_at": "2026-04-16T12:34:56.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total": 100,
      "sort": "created_at:desc",
      "search": "jane"
    }
  }
}