---
agentTools:
  projectIndex: https://hirely.readme.io/llms.txt
---

# Kunde erstellen

Erstellt ein neues Unternehmen, welches von deiner Agentur verwaltet werden kann.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Hirely API v2",
    "version": "2.0"
  },
  "servers": [
    {
      "url": "https://hirely.de/api/v2"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "x-default": "{api_key}",
        "name": "Authorization",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/{company_id}/agency_customer": {
      "post": {
        "summary": "Kunde erstellen",
        "description": "Erstellt ein neues Unternehmen, welches von deiner Agentur verwaltet werden kann.",
        "operationId": "kunde-erstellen",
        "parameters": [
          {
            "name": "company_id",
            "in": "path",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "street",
                  "zipcode",
                  "city",
                  "country",
                  "state"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Name des Kunden - Max. 50 Zeichen"
                  },
                  "street": {
                    "type": "string",
                    "description": "Straße & Hausnummer der Adresse. - Max. 100 Zeichen"
                  },
                  "zipcode": {
                    "type": "string",
                    "description": "Postleitzahl der Adresse. - Max. 10 Zeichen"
                  },
                  "city": {
                    "type": "string",
                    "description": "Stadt der Adresse. - Max. 50 Zeichen"
                  },
                  "country": {
                    "type": "string",
                    "description": "Ländercode der Adresse. - Max. 2 Zeichen"
                  },
                  "state": {
                    "type": "string",
                    "description": "Bundesland der Adresse. - Max. 50 Zeichen"
                  },
                  "customer_group_id": {
                    "type": "integer",
                    "description": "ID der Kundengruppe, in welche der Kunde eingeteilt werden soll",
                    "format": "int32"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"data\": {\n        \"id\": \"com_keEB36KYvqDVm\",\n        \"name\": \"Musterkunde GmbH\",\n        \"email\": null,\n        \"phone\": null,\n        \"identifier\": \"musterkunde-gmbh\",\n        \"links\": {\n            \"website_url\": null,\n            \"career_page_url\": \"https://hirely.de/u/musterkunde-gmbh\",\n            \"imprint_url\": null,\n            \"data_protection_url\": null\n        },\n        \"images\": {\n            \"logo_url\": \"https://d2r5zvi5nwvpur.cloudfront.net/2b5fc1d6-48f8-448a-9caf-0531a530ed8c/assets/img/avatars/default-company-logo.png\",\n            \"squared_logo_url\": \"https://d2r5zvi5nwvpur.cloudfront.net/2b5fc1d6-48f8-448a-9caf-0531a530ed8c/assets/img/avatars/default-company-squared-logo.webp\",\n            \"favicon_url\": \"https://d2r5zvi5nwvpur.cloudfront.net/2b5fc1d6-48f8-448a-9caf-0531a530ed8c/assets/img/avatars/default-company-favicon.png\",\n            \"logo_size\": [\n                472,\n                130\n            ],\n            \"favicon_size\": null,\n            \"platform_logo_url\": \"https://d2r5zvi5nwvpur.cloudfront.net/2b5fc1d6-48f8-448a-9caf-0531a530ed8c/assets/img/brand/logo.svg\",\n            \"platform_icon_url\": \"https://d2r5zvi5nwvpur.cloudfront.net/2b5fc1d6-48f8-448a-9caf-0531a530ed8c/assets/img/brand/logo-icon.svg\"\n        },\n        \"scripts\": {\n            \"global\": null,\n            \"careerpage\": null,\n            \"careerportal\": null\n        },\n        \"created_at\": \"2023-09-03T19:47:47+02:00\",\n        \"updated_at\": \"2023-09-03T19:48:06+02:00\",\n        \"managed_by_id\": \"com_oNxKRWG2oq8dg\"\n    }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "com_keEB36KYvqDVm"
                        },
                        "name": {
                          "type": "string",
                          "example": "Musterkunde GmbH"
                        },
                        "email": {},
                        "phone": {},
                        "identifier": {
                          "type": "string",
                          "example": "musterkunde-gmbh"
                        },
                        "links": {
                          "type": "object",
                          "properties": {
                            "website_url": {},
                            "career_page_url": {
                              "type": "string",
                              "example": "https://hirely.de/u/musterkunde-gmbh"
                            },
                            "imprint_url": {},
                            "data_protection_url": {}
                          }
                        },
                        "images": {
                          "type": "object",
                          "properties": {
                            "logo_url": {
                              "type": "string",
                              "example": "https://d2r5zvi5nwvpur.cloudfront.net/2b5fc1d6-48f8-448a-9caf-0531a530ed8c/assets/img/avatars/default-company-logo.png"
                            },
                            "squared_logo_url": {
                              "type": "string",
                              "example": "https://d2r5zvi5nwvpur.cloudfront.net/2b5fc1d6-48f8-448a-9caf-0531a530ed8c/assets/img/avatars/default-company-squared-logo.webp"
                            },
                            "favicon_url": {
                              "type": "string",
                              "example": "https://d2r5zvi5nwvpur.cloudfront.net/2b5fc1d6-48f8-448a-9caf-0531a530ed8c/assets/img/avatars/default-company-favicon.png"
                            },
                            "logo_size": {
                              "type": "array",
                              "items": {
                                "type": "integer",
                                "example": 472,
                                "default": 0
                              }
                            },
                            "favicon_size": {},
                            "platform_logo_url": {
                              "type": "string",
                              "example": "https://d2r5zvi5nwvpur.cloudfront.net/2b5fc1d6-48f8-448a-9caf-0531a530ed8c/assets/img/brand/logo.svg"
                            },
                            "platform_icon_url": {
                              "type": "string",
                              "example": "https://d2r5zvi5nwvpur.cloudfront.net/2b5fc1d6-48f8-448a-9caf-0531a530ed8c/assets/img/brand/logo-icon.svg"
                            }
                          }
                        },
                        "scripts": {
                          "type": "object",
                          "properties": {
                            "global": {},
                            "careerpage": {},
                            "careerportal": {}
                          }
                        },
                        "created_at": {
                          "type": "string",
                          "example": "2023-09-03T19:47:47+02:00"
                        },
                        "updated_at": {
                          "type": "string",
                          "example": "2023-09-03T19:48:06+02:00"
                        },
                        "managed_by_id": {
                          "type": "string",
                          "example": "com_oNxKRWG2oq8dg"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": false
  },
  "x-readme-fauxas": true,
  "_id": "64be9f338f61960050f9be50:64e8dab21a240a0032467bf6"
}
```