# Create a signature layout

Creates a signature layout for the specified organization and returns its identifier. The `name` is a slug of 1-50 characters (letters, digits and hyphens, not starting or ending with a hyphen), unique within the organization; `default` is reserved. When the `dateTime` row is visible, `format` must be one of the `code` values returned by GET /api/v1/datetime-formats and `localTimezone` is required: when it is false, `timezone` must be exactly one of the `code` values returned by GET /api/v1/timezones; when it is true, `timezone` must be omitted. The optional image accepts the MIME types image/png, image/jpeg, image/gif and image/webp, up to 716800 base64 characters (about 512 KB). Validation errors are returned as 422.

Endpoint: POST /api/v1/organizations/{organizationId}/settings/signature/layouts
Version: v1
Security: Bearer, PersonalAccessToken

## Security:

  - `Bearer` (unknown)
    http bearer JWT

  - `PersonalAccessToken` (unknown)
    apiKey in header Personal-Access-Token

## Path parameters:

  - `organizationId` (string, required)
    Unique identifier of the organization

## Request fields (application/json):

  - `name` (string, required)
    The name: 1-50 letters, digits or hyphens, not starting or ending with a hyphen. Unique within the organization. "default" is reserved.

  - `fields` (object, required)
    The configuration of the fields shown in the signature appearance.

  - `fields.signerName` (object, required)
    A row of the signature appearance.

  - `fields.signerName.visible` (boolean, required)
    Whether the row is shown.

  - `fields.dateTime` (object, required)
    The date and time row of the signature appearance.

  - `fields.dateTime.visible` (boolean, required)
    Whether the row is shown.

  - `fields.dateTime.format` (string)
    The date and time format: exactly one of the `code` values returned by GET /api/v1/datetime-formats. Required when the row is visible.

  - `fields.dateTime.localTimezone` (boolean)
    Whether the date and time are shown in the signer's local timezone. Required when the row is visible. When true, `timezone` must be omitted.

  - `fields.dateTime.timezone` (string)
    The IANA timezone: exactly one of the `code` values returned by GET /api/v1/timezones. Required when `localTimezone` is false.

  - `image` (object)
    The image of the signature appearance.

  - `image.mimeType` (string, required)
    The MIME type: image/png, image/jpeg, image/gif or image/webp.

  - `image.dataBase64` (string, required)
    The base64 encoded image, up to 716800 characters (about 512 KB).

  - `image.position` (string, required)
    The position of the image relative to the signature text.
    Enum: "Background", "Above", "Below", "Left", "Right"

## Response 201:

  - `201` (unknown)
    Created

## Response 201 fields (application/json):

  - `id` (string, required)
    The identifier of the created signature layout.

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 400 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 404:

  - `404` (unknown)
    Not Found

## Response 404 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 422:

  - `422` (unknown)
    Unprocessable Content

## Response 422 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

## Response 500:

  - `500` (unknown)
    Internal Server Error

## Response 500 fields (application/json):

  - `errors` (array, required)

  - `errors.errorId` (string, required)

  - `errors.field` (string)

  - `errors.message` (any, required)

  - `errors.messageEn` (any, required)

  - `errors.additionalData` (object)

