# Create a new Auditable entity

Create a new Auditable entity, which can be used for auditing


Endpoint: POST /v2/audits/entities
Security: Bearer-Auth

## Request fields (application/json):

  - `legal_name` (string)
    The legal name of the entity.
    Example: "Test Company Inc."

  - `email` (string)
    The email address associated with the entity.
    Example: "test@squake.earth"

  - `vat_id` (string)
    The VAT identification number of the entity.
    Example: "DE123456789"

  - `external_id` (string)
    An external identifier for the entity, which can be used to link the entity to an external system or database.
    Example: "external-id"

  - `address` (object)
    Address of a legal entity. Some (legal) documets require a full address to be given, e.g. an invoice.
    Example: {"city":"Berlin","line1":"Street 1","line2":"Building A","email":"test@squake.earth","country_alpha2":"DE","state":"BE","postal_code":"12345"}

  - `address.city` (string, required)
    City, town, village,...
    Example: "Berlin"

  - `address.line1` (string, required)
    Street name and number, P.O. box, c/o,...
    Example: "Street 1"

  - `address.line2` (string)
    Additional address information, e.g. building, floor, ...
    Example: "Building A"

  - `address.email` (string)
    Email address associated with this address
    Example: "test@squake.earth"

  - `address.country_alpha2` (string, required)
    Two-letter or three-letter code as defined in ISO 3166-1 alpha-2 and alpha-3 respectively.
    Example: "DE"

  - `address.state` (string)
    County, Province, Region, State,...
    Example: "BE"

  - `address.postal_code` (string, required)
    ZIP or postal code
    Example: "12345"

## Response 201 fields (application/json):

  - `id` (string)
    A unique identifier for the audit entity record, represented as a universally unique identifier (UUID)

  - `legal_name` (string)
    The legal name of the entity.
    Example: "Test Company Inc."

  - `email` (string)
    The email address associated with the entity.

  - `vat_id` (string)
    The VAT identification number of the entity.
    Example: "DE123456789"

  - `external_id` (string)
    An external identifier for the entity, which can be used to link the entity to an external system or database.
    Example: "external-id"

  - `address` (object)
    Address of a legal entity. Some (legal) documets require a full address to be given, e.g. an invoice.

  - `address.city` (string, required)
    City, town, village,...

  - `address.line1` (string, required)
    Street name and number, P.O. box, c/o,...

  - `address.line2` (string)
    Additional address information, e.g. building, floor, ...

  - `address.email` (string)
    Email address associated with this address

  - `address.country_alpha2` (string, required)
    Two-letter or three-letter code as defined in ISO 3166-1 alpha-2 and alpha-3 respectively.

  - `address.state` (string)
    County, Province, Region, State,...

  - `address.postal_code` (string, required)
    ZIP or postal code

## Response 403 fields (application/json):

  - `errors` (array)

  - `errors.code` (string, required)
    An application-specific error code, expressed as a string value.
    Enum: "field_validation_error", "server_error", "not_authorized", "not_found", "invalid_methodology", "invalid_type"

  - `errors.detail` (string)
    A human-readable explanation specific to this occurrence of the problem. Like title, this field's value can be localized.

  - `errors.source` (object)
    An object containing references to the primary source of the error

  - `errors.source.id` (string)

  - `errors.source.attribute` (string, required)

  - `errors.source.model` (string)