---
updatedAt: 2025-06-12T00:07:17.000Z
agentTools:
  projectIndex: https://developers.tap.company/llms.txt
---

# Create a Business

This endpoint allows you to create a business.

For every business created, you can add entities, brands, branches, and other related information, granting you access to all features in Tap.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "business.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.tap.company/v2/business"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-bearer-format": "bearer",
        "x-default": "sk_test_BPmcTgEfuK1dHslMaLGY42Ry"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/": {
      "post": {
        "summary": "Create a Business",
        "description": "This endpoint allows you to create a business.",
        "operationId": "create-a-business",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "type",
                  "entity",
                  "brands"
                ],
                "properties": {
                  "name": {
                    "type": "object",
                    "description": "Name object accepts multiple languages. Languages that are accepted ar,en,fr,fa,es,ru,tl,it,nl,de,tr,hi,ml,ur,pa,te,ta,bn and zh",
                    "properties": {
                      "en": {
                        "type": "string",
                        "description": "The legal brand name of the business in English (minimum 3 characters).",
                        "default": "Brand Name"
                      }
                    }
                  },
                  "type": {
                    "type": "string",
                    "description": "The type of business. The accepted values are \"ind\" or \"corp\". Use \"ind\" for individual based businesses (e.g. Instagram businesses, freelancers etc.) and \"corp\" for registered businesses.",
                    "default": "corp"
                  },
                  "entity": {
                    "type": "object",
                    "description": "The entity details of the business.",
                    "properties": {
                      "license": {
                        "type": "object",
                        "properties": {
                          "number": {
                            "type": "string",
                            "description": "The ID of the license (no validation required).",
                            "default": "2134342SE"
                          }
                        }
                      },
                      "country": {
                        "type": "string",
                        "description": "The country where the business located. The value ISO2 code accepted.",
                        "default": "KW"
                      }
                    }
                  },
                  "contact_person": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "object",
                        "description": "The name of the contact person.",
                        "properties": {
                          "title": {
                            "type": "string",
                            "default": "Mr"
                          },
                          "first": {
                            "type": "string",
                            "default": "Test"
                          },
                          "middle": {
                            "type": "string",
                            "description": "Test",
                            "default": "Test"
                          },
                          "last": {
                            "type": "string",
                            "default": "Test"
                          }
                        }
                      },
                      "contact_info": {
                        "type": "object",
                        "description": "The contact information.",
                        "properties": {
                          "primary": {
                            "type": "object",
                            "properties": {
                              "email": {
                                "type": "string",
                                "description": "The email address of the contact. No length validation required.",
                                "default": "test@test.com"
                              },
                              "phone": {
                                "type": "object",
                                "description": "The phone number of the merchant. Validation is based on the country, with different lengths for each country's phone number.",
                                "properties": {
                                  "country_code": {
                                    "type": "string",
                                    "default": "965"
                                  },
                                  "number": {
                                    "type": "string",
                                    "default": "51234567"
                                  }
                                }
                              }
                            }
                          }
                        }
                      },
                      "nationality": {
                        "type": "string",
                        "description": "The nationality of the contact person.",
                        "default": "KW"
                      },
                      "date_of_birth": {
                        "type": "string",
                        "description": "The date of birth  of the contact person.",
                        "default": "2000-01-02"
                      },
                      "is_authorized": {
                        "type": "boolean",
                        "description": "boolean flag to denote whether the contact person is an authorized signatory. Indicates if the contact person has authorization.",
                        "default": true
                      },
                      "authorization": {
                        "type": "object",
                        "description": "The name of the authorized person.",
                        "properties": {
                          "name": {
                            "type": "object",
                            "properties": {
                              "title": {
                                "type": "string",
                                "default": "Mr"
                              },
                              "first": {
                                "type": "string",
                                "default": "Test"
                              },
                              "middle": {
                                "type": "string",
                                "description": "Test",
                                "default": "Test"
                              },
                              "last": {
                                "type": "string",
                                "default": "Test"
                              }
                            }
                          },
                          "type": {
                            "type": "string",
                            "description": "The authorization type for the contact person. Accepts the following values: identity_document (default), civil_id, national_id, passport.",
                            "default": "identity_document"
                          },
                          "issuing_country": {
                            "type": "string",
                            "default": "KW"
                          },
                          "issuing_date": {
                            "type": "string",
                            "default": "2012-03-03"
                          },
                          "expiry_date": {
                            "type": "string",
                            "default": "2020-03-03"
                          },
                          "files": {
                            "type": "array",
                            "default": [
                              "file_984450183956131840"
                            ],
                            "items": {
                              "type": "string"
                            }
                          }
                        }
                      },
                      "identification": {
                        "type": "array",
                        "items": {
                          "properties": {
                            "name": {
                              "type": "object",
                              "description": "Contact full name details",
                              "properties": {
                                "title": {
                                  "type": "string",
                                  "description": "The title of the individual. Accepts only the following values: Mr., Mrs., Ms., Prof. (Professor), Dr. (Doctor). This is an optional field.",
                                  "default": "Mr"
                                },
                                "first": {
                                  "type": "string",
                                  "description": "The first name of the merchant owner. Must be at least 3 characters long.",
                                  "default": "Muhammed"
                                },
                                "middle": {
                                  "type": "string",
                                  "description": "The middle name of the merchant owner. Must be at least 1 character if provided.",
                                  "default": "L"
                                },
                                "last": {
                                  "type": "string",
                                  "description": "The last name of the merchant owner. Must be at least 3 characters long.",
                                  "default": "Fazan"
                                }
                              }
                            },
                            "type": {
                              "type": "string",
                              "description": "The type of identification document attached.",
                              "default": "identity_document"
                            },
                            "number": {
                              "type": "string",
                              "description": "The identification number",
                              "default": "312312313"
                            },
                            "issuing_country": {
                              "type": "string",
                              "description": "Identification issuing country in ISO 2 format",
                              "default": "AE"
                            },
                            "issuing_date": {
                              "type": "string",
                              "description": "Identification issuing date",
                              "default": "2012-02-02"
                            },
                            "expiry_date": {
                              "type": "string",
                              "description": "Identification expiry date",
                              "default": "2025-03-03"
                            },
                            "files": {
                              "type": "array",
                              "description": "Front and Back files IDs uploaded for the identification document",
                              "default": [],
                              "items": {
                                "type": "string"
                              }
                            }
                          },
                          "required": [
                            "number"
                          ],
                          "type": "object"
                        }
                      }
                    }
                  },
                  "brands": {
                    "type": "array",
                    "description": "The brand of the business.",
                    "items": {
                      "properties": {
                        "name": {
                          "type": "object",
                          "description": "Name of the object is \"name\". Brand name can be added In multiple languages. Languages that are accepted ar,en,fr,fa,es,ru,tl,it,nl,de,tr,hi,ml,ur,pa,te,ta,bn and zh",
                          "properties": {
                            "en": {
                              "type": "string",
                              "description": "The legal brand name of the business in English (minimum 3 characters).",
                              "default": "Brand Name"
                            }
                          }
                        }
                      },
                      "type": "object"
                    }
                  },
                  "post": {
                    "type": "object",
                    "description": "The url of the webhook.",
                    "properties": {
                      "url": {
                        "type": "string",
                        "description": "After completed, Tap will post the business response to this url.",
                        "default": "http://test.company/post_url"
                      }
                    }
                  },
                  "metadata": {
                    "type": "object",
                    "description": "The used defined \"key\": \"value\" pairs to be passed in the business object.",
                    "properties": {
                      "mtd": {
                        "type": "string",
                        "description": "Set of key/value pairs that you can attach to an object. It can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.",
                        "default": "metadata"
                      }
                    }
                  },
                  "idempotent": {
                    "type": "string",
                    "description": "The idempotent string to restrict duplicate creation of business. If the same idempotent string is passed, a new business will not be created, whereas the response of the first business will be returned."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```