# 📋 Create mandate with directory entry

Create a new mandate with its associated directory entry.

This endpoint creates both:
1. A directory entry for routing invoices to the company
2. A mandate granting permission to manage invoices for this entity

The mandate defines the scope of operations the sponsor can perform
for this legal entity (SIREN, SIRET, or routing code level).

Endpoint: POST /mandates
Version: 1.0.0

## Header parameters:

  - `X-PDP-Client-Id` (string, required)
    ID of the PDP Client for which the operation is performed

## Request fields (application/json):

  - `start_date` (string, required)
    When the mandate should become active
    Example: "2024-01-15T00:00:00Z"

  - `end_date` (any)
    When the mandate should expire (optional)
    Example: "2024-12-31T23:59:59Z"

  - `directory_entry` (object, required)
    Directory entry information for the mandated entity

  - `directory_entry.siren` (string, required)
    Company identification number (SIREN)

  - `directory_entry.name` (string, required)
    Company name

  - `directory_entry.suffix` (any)
    Service suffix - when using simple SIREN+suffix nomenclature

  - `directory_entry.siret` (any)
    Establishment identification number (SIRET)

  - `directory_entry.routing_identifier` (any)
    Routing identifier

  - `directory_entry.routing_identifier_type` (any)
    Type of routing identifier

  - `directory_entry.routing_code_label` (any)
    Label for the routing code

  - `directory_entry.establishment_nature` (any)
    Nature of the establishment

  - `directory_entry.legal_commitment_management` (any)
    Legal commitment management status

  - `directory_entry.administrative_status` (any)
    Administrative status

  - `directory_entry.addressable` (any)
    Whether the company is addressable

  - `directory_entry.address` (any)
    Establishment address

  - `directory_entry.created_at` (any)
    When the entry was created

  - `directory_entry.updated_at` (any)
    When the entry was last updated

  - `file_attachment` (any)
    Optional file attachment for the mandate

## Response 201 fields (application/json):

  - `mandate` (object, required)
    Mandate model with all information.

  - `mandate.id` (any)
    Unique mandate identifier

  - `mandate.client_id` (string, required)
    Reference to the client who owns this mandate

  - `mandate.start_date` (string, required)
    When the mandate becomes active

  - `mandate.end_date` (any)
    When the mandate expires (optional)

  - `mandate.file_attachment` (any)
    Optional file attachment for the mandate

  - `mandate.status` (string, required)
    Current status of the mandate
    Enum: "created", "pending_kyc", "active", "expired"

  - `mandate.directory_entry` (object, required)
    Directory entry information for the mandated entity

  - `mandate.directory_entry.siren` (string, required)
    Company identification number (SIREN)

  - `mandate.directory_entry.name` (string, required)
    Company name

  - `mandate.directory_entry.suffix` (any)
    Service suffix - when using simple SIREN+suffix nomenclature

  - `mandate.directory_entry.siret` (any)
    Establishment identification number (SIRET)

  - `mandate.directory_entry.routing_identifier` (any)
    Routing identifier

  - `mandate.directory_entry.routing_identifier_type` (any)
    Type of routing identifier

  - `mandate.directory_entry.routing_code_label` (any)
    Label for the routing code

  - `mandate.directory_entry.establishment_nature` (any)
    Nature of the establishment

  - `mandate.directory_entry.legal_commitment_management` (any)
    Legal commitment management status

  - `mandate.directory_entry.administrative_status` (any)
    Administrative status

  - `mandate.directory_entry.addressable` (any)
    Whether the company is addressable

  - `mandate.directory_entry.address` (any)
    Establishment address

  - `mandate.directory_entry.created_at` (any)
    When the entry was created

  - `mandate.directory_entry.updated_at` (any)
    When the entry was last updated

  - `mandate.created_at` (string, required)
    When the mandate was created

  - `mandate.updated_at` (any)
    When the mandate was last updated

  - `message` (string, required)
    Response message
    Example: "Mandate created successfully"

## Response 400 fields (application/json):

  - `error` (string, required)

  - `code` (integer, required)

  - `trace_id` (string, required)

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)


## Response 409 fields