Move Money
Webhooks
Create Business
Create a business entity and link it to a representative user.
curl --request POST \
--url https://api.example.com/api/v3/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"
}
}
}Documentation Index
Fetch the complete documentation index at: https://developers.ingopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
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
Identifier of the representative user. Required.
"user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef"
Legal business name.
Primary email address for the business.
"jane.doe@example.com"
Phone number in E.164 format.
"+12125551234"
Business onboarding field: business address.
Business onboarding field: business industry.
ISO 3166-1 alpha-2 country code.
ISO 3166-2 two-letter state/region code.
City.
Business onboarding field: incorporated date.
Business onboarding field: incorporated state.
Program API key. Accepted either in the api_key HTTP header or as this body field.
Optional display name. Defaults to business_name when omitted.
Business onboarding field: business email.
Business onboarding field: business phone.
Business onboarding field: business phone number.
Business onboarding field: support email.
Business onboarding field: support phone number.
Business onboarding field: website.
Business onboarding field: business address 2.
Business onboarding field: naics code.
Business onboarding field: business type.
5-digit US ZIP code.
Business onboarding field: business description.
Business onboarding field: ein.
Business onboarding field: logo.
Business onboarding field: business logo.
Business onboarding field: ach engine.
Legal name of the business representative.
Business onboarding field: business rep email.
Business onboarding field: business rep job title.
Business onboarding field: business rep dob.
Business onboarding field: business rep address.
Business onboarding field: business rep address 2.
Business onboarding field: business rep zipcode.
Business onboarding field: business rep city.
Business onboarding field: business rep phone.
Business onboarding field: business rep ssn.
Business onboarding field: business rep website.
Business onboarding field: business rep country.
Business onboarding field: business rep state.
Business onboarding field: delivery fufilment.
Business onboarding field: support address one.
Business onboarding field: support address two.
Business onboarding field: support country.
Business onboarding field: support city.
Business onboarding field: support zipcode.
Business onboarding field: support state.
Business onboarding field: business proof.
Business onboarding field: personal id.
Business onboarding field: send email notification.
Business onboarding field: otp.
Business onboarding field: security.
Response
Success.
success "operation completed"
Endpoint-specific payload; shape varies per operation.
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Business entity id; prefix buss-.
"buss-2ef94c60-5a11-4d72-a3c1-5be7fab0123e"
User entity id; prefix user-.
"user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef"
"Acme Cafe LLC"
"12-3456789"
"llc"
"food_service"
"jane.doe@example.com"
"+12125551234"
"jane.doe@example.com"
"+12125551234"
"active"
"verified"
"2026-04-16T12:34:56.000Z"
"2026-04-16T12:34:56.000Z"
curl --request POST \
--url https://api.example.com/api/v3/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"
}
}
}