---
title: "Creates policy subscription."
method: POST
path: "/sales/v2/individual/travel/policies"
---

# Creates policy subscription.

`POST /sales/v2/individual/travel/policies`

Cf. summary

## Headers

- `accept-language` string
- `x-axa-context` string, JSON Web Token RFC 7519
- `x-tenant-id` string

## Request body

- object
  - `external_policy_number` string — External policy identifier that can be provided by the partner.
  - `subscription_country` string — Country where the customer subscribes the policy, ISO-3166-1 alpha-2 format (2 letter codes).
  - `quote_code` string, required — Quote code, partner can use a default value if provided by AXA or got it with quoting API.
  - `policy_start_date` string, date — The effective policy start date - ISO 8601 format (YYYY-MM-DD).
  - `domain_url` string — The url from the request is originated.
  - `sales_information` object — Sales information.
    - `point_of_sale` string — Point of sale of the policy.
    - `seller` string — Seller who sold the policy
  - `price` object, required — Policy price.
    - `formula` string — Formula selected by the customer.
    - `currency` string, required — Currency, ISO 4217 format (3 letter code).
    - `price_after_discount_inc_tax` number, required — Price amount discounted including taxes, numeric with 2 decimals.
  - `addons` string[] — List of add-ons codes (both, regular and temporary ones), add-ons added by the customer.
  - `policy_holder` object, required — Policy holder
    - `title` 'MR' | 'MS' | 'MISS' | 'DR' | 'PR', required — Civility (Mr, Ms, Miss, Doctor, Professor).
    - `first_name` string, required — First name.
    - `middle_name` string — Middle name.
    - `last_name` string, required — Last name.
    - `birth_date` string, date, required — Birth date - ISO 8601 format (YYYY-MM-DD).
    - `email` string, email, required — Email address.
    - `registrations` object[] — List of person registrations.
      - `registration_type` 'ID_CARD' | 'PASSPORT' | 'DRIVER_LICENSE' | 'TAX_REGISTRATION' | 'RESIDENCE_PERMIT' — Type of person registration. ID_CARD : Identity card reference PASSPORT : Passport reference DRIVER_LICENSE : Driver license reference TAX_REGISTRATION : Tax registration reference RESIDENCE_PERMIT: Residente permit reference
      - `value` string, required — Value of the registration.
    - `spoken_language` string, required — Spoken language, IANA language codification.
    - `phone` object — Phone number.
      - `international_prefix` string — Prefix to be added to be called from abroad.
      - `number` string, required — Phone number. Can be local or international.
    - `address` object — Postal address
      - `street_address` string, required — Street address.
      - `postal_code` string, required — Postal code or zip code.
      - `city` string, required — City.
      - `country` string, required — Country ISO-3166-1 alpha-2 format (2 letter codes).
    - `is_policy_beneficiary` boolean, required — Indicates if the policy holder is also a policy beneficiary.
    - `external_holder_id` string — Partner identifier of the customer.
  - `beneficiaries` object[] — Beneficiaries list (other than the policy holder if he is also a beneficiary).
    - `title` 'MR' | 'MS' | 'MISS' | 'DR' | 'PR', required — Civility (Mr, Ms, Miss, Doctor, Professor).
    - `first_name` string, required — First name.
    - `middle_name` string — Middle name.
    - `last_name` string, required — Last name.
    - `birth_date` string, date, required — Birth date - ISO 8601 format (YYYY-MM-DD).
    - `email` string, email — Email address.
    - `registrations` object[] — List of person registrations.
      - `registration_type` 'ID_CARD' | 'PASSPORT' | 'DRIVER_LICENSE' | 'TAX_REGISTRATION' | 'RESIDENCE_PERMIT' — Type of person registration. ID_CARD : Identity card reference PASSPORT : Passport reference DRIVER_LICENSE : Driver license reference TAX_REGISTRATION : Tax registration reference RESIDENCE_PERMIT: Residente permit reference
      - `value` string, required — Value of the registration.
  - `motor_coverages` object — Insured motor assets.
    - `insured_items` object — Beneficiaries list for motor products
      - `vehicles` object[] — Vehicle specific information
        - `registration_number` string — Car's license plate
        - `brand` string — Brand name
        - `model` string — Model
        - `colour` string — Vehicle's colour
  - `consents` object[] — List of consents displayed to the customer.
    - `code` string, required — Code of the consent.
    - `is_confirmed` boolean, required — Indicates if the consent has been confirmed by the customer or not.
  - `payment` object — Payment information, at least one of the properties psp_transaction_id or transfer_information should be provided.
    - `type` 'CREDIT_CARD' | 'DEBIT_CARD' | 'ELECTRONIC_TRANSFERT' | 'VIRTUAL_CREDIT_CARD' | 'DIRECT_PAYMENT' — Payment mode selected.
    - `psp_transaction_id` string — Payment reference on the payment provider system.
    - `transfer_information` object — Information about the payer.
      - `account_holder` object
        - `first_name` string — First name of the account's owner.
        - `last_name` string — Last name of the account's owner.
        - `billing_address` object
          - `street_address` string — Street address.
          - `postal_code` string — Postal code or zip code.
          - `city` string — City.
          - `country` string — Country.
          - `province` string — Province.
      - `account_name` string — Name's of this bank account
      - `country_code` string — Bank's country code, ISO-3166-1 alpha-2 format (2 letters code).
      - `wire_code` object[]
        - `wire_code_type` 'IBAN' — Wire's type (only IBAN is accepted)
        - `value` string — The value of the IBAN
  - `additional_information` object[] — Additional information filled by the partner if needed.
    - `code` 'EXISTING_INSURANCE_REFERENCE' | 'REGISTRATION_PLATE_NUMBER', required — Information code. - EXISTING_INSURANCE_REFERENCE: References to existing or complementary insurance - REGISTRATION_PLATE_NUMBER: vehicle license plate reference
    - `value` string, required — Information value.
  - `has_to_send_email_immediately` boolean — Indicates if the draft email should be sent immediately.
  - `utm_parameters` object — UTM parameters for tracking marketing campaigns and traffic sources
    - `source` string — Identifies which site sent the traffic (e.g., search engine, newsletter, or other referral source).
    - `medium` string — Identifies the marketing medium used to reach the user (e.g., email, CPC, banner).
    - `campaign` string — Identifies the specific campaign name or promotion associated with the traffic.
    - `term` string — Identifies keywords associated with the campaign.
    - `content` string — Differentiates between links or ads pointing to the same URL, used for A/B testing.

## Response `201`

Policy created.

- object
  - `policy_id` string — Unique final policy identifier.
  - `draft_policy_number` string — Draft policy number, provided in case if the policy is not confirmed.
  - `quote_code` string, required — Quote code, partner can use a default value if provided by AXA or got it with quoting API.
  - `policy_number` string — Final policy number.
  - `external_policy_number` string — External policy identifier that can be provided by the partner.
  - `status` object — Policy status.
    - `value` 'CONFIRMED' | 'DRAFT' | 'CANCELLED', required — Status value
    - `reason` string — Status reason.
  - `subscription_country` string — Country where the customer subscribes the policy, ISO-3166-1 alpha-2 format (2 letter codes).
  - `sales_information` object — Sales information.
    - `point_of_sale` string — Point of sale of the policy.
    - `seller` string — Seller who sold the policy
  - `price` object, required — Policy price.
    - `formula` string — Formula selected by the customer.
    - `currency` string, required — Currency, ISO 4217 format (3 letter code).
    - `price_after_discount_inc_tax` number, required — Price amount discounted including taxes, numeric with 2 decimals.
  - `addons` string[] — List of add-ons codes (both, regular and temporary ones), add-ons added by the customer.
  - `policy_holder` object, required — Policy holder
    - `title` 'MR' | 'MS' | 'MISS' | 'DR' | 'PR', required — Civility (Mr, Ms, Miss, Doctor, Professor).
    - `first_name` string, required — First name.
    - `middle_name` string — Middle name.
    - `last_name` string, required — Last name.
    - `birth_date` string, date, required — Birth date - ISO 8601 format (YYYY-MM-DD).
    - `email` string, email, required — Email address.
    - `registrations` object[] — List of person registrations.
      - `registration_type` 'ID_CARD' | 'PASSPORT' | 'DRIVER_LICENSE' | 'TAX_REGISTRATION' | 'RESIDENCE_PERMIT' — Type of person registration. ID_CARD : Identity card reference PASSPORT : Passport reference DRIVER_LICENSE : Driver license reference TAX_REGISTRATION : Tax registration reference RESIDENCE_PERMIT: Residente permit reference
      - `value` string, required — Value of the registration.
    - `spoken_language` string, required — Spoken language, IANA language codification.
    - `phone` object — Phone number.
      - `international_prefix` string — Prefix to be added to be called from abroad.
      - `number` string, required — Phone number. Can be local or international.
    - `address` object — Postal address
      - `street_address` string, required — Street address.
      - `postal_code` string, required — Postal code or zip code.
      - `city` string, required — City.
      - `country` string, required — Country ISO-3166-1 alpha-2 format (2 letter codes).
    - `is_policy_beneficiary` boolean, required — Indicates if the policy holder is also a policy beneficiary.
    - `external_holder_id` string — Partner identifier of the customer.
  - `beneficiaries` object[] — Beneficiaries list (other than the policy holder if he is also a beneficiary).
    - `id` string — Beneficiary identifier.
    - `title` 'MR' | 'MS' | 'MISS' | 'DR' | 'PR', required — Civility (Mr, Ms, Miss, Doctor, Professor).
    - `first_name` string, required — First name.
    - `middle_name` string — Middle name.
    - `last_name` string, required — Last name.
    - `birth_date` string, date, required — Birth date - ISO 8601 format (YYYY-MM-DD).
    - `email` string, email — Email address.
    - `registrations` object[] — List of person registrations.
      - `registration_type` 'ID_CARD' | 'PASSPORT' | 'DRIVER_LICENSE' | 'TAX_REGISTRATION' | 'RESIDENCE_PERMIT' — Type of person registration. ID_CARD : Identity card reference PASSPORT : Passport reference DRIVER_LICENSE : Driver license reference TAX_REGISTRATION : Tax registration reference RESIDENCE_PERMIT: Residente permit reference
      - `value` string, required — Value of the registration.
  - `motor_coverages` object — Insured motor assets.
    - `insured_items` object — Beneficiaries list for motor products
      - `vehicles` object[] — Vehicle specific information
        - `registration_number` string — Car's license plate
        - `brand` string — Brand name
        - `model` string — Model
        - `colour` string — Vehicle's colour
  - `consents` object[] — List of consents displayed to the customer.
    - `code` string, required — Code of the consent.
    - `is_confirmed` boolean, required — Indicates if the consent has been confirmed by the customer or not.
  - `payment_technical_information` object — Technical information for payment system access. This information is provided to the API caller to allow it to complete the payment.
    - `zuora_access` object, required — Access information specific to Zuora.
      - `payment_gateway` string, required — Payment gateway code.
      - `key` string, required — Public key generated for the subscription.
      - `signature` string, required — Digital signature generated for the subscription.
      - `token` string, required — Token generated for the subscription.
      - `tenant_id` string, required — ID of the Zuora tenant.
      - `page_id` string, required — The page id.
  - `payment` object — Payment information, at least one of the properties psp_transaction_id or transfer_information should be provided.
    - `type` 'CREDIT_CARD' | 'DEBIT_CARD' | 'ELECTRONIC_TRANSFERT' | 'VIRTUAL_CREDIT_CARD' | 'DIRECT_PAYMENT' — Payment mode selected.
    - `psp_transaction_id` string — Payment reference on the payment provider system.
    - `transfer_information` object — Information about the payer.
      - `account_holder` object
        - `first_name` string — First name of the account's owner.
        - `last_name` string — Last name of the account's owner.
        - `billing_address` object
          - `street_address` string — Street address.
          - `postal_code` string — Postal code or zip code.
          - `city` string — City.
          - `country` string — Country.
          - `province` string — Province.
      - `account_name` string — Name's of this bank account
      - `country_code` string — Bank's country code, ISO-3166-1 alpha-2 format (2 letters code).
      - `wire_code` object[]
        - `wire_code_type` 'IBAN' — Wire's type (only IBAN is accepted)
        - `value` string — The value of the IBAN
  - `attachments` object[] — Set of attachments provided with the policy.
    - `name` string, required — Attached document name.
    - `content_url` string, required — URL to download the document.
    - `type` string — Indicates the type of the document, it can be: - TERMS_AND_CONDITIONS; - CONTRACT; - ...
    - `created_at` string, date — Date and time of document creation - ISO 8601 format (YYYY-MM-DD).
    - `sent_by` string[] — The attachment sent via confirmation email or precontractual email.
    - `technical_reference` string — The technical reference used to download the attachment.
  - `additional_information` object[] — Additional information filled by the partner if needed.
    - `code` 'EXISTING_INSURANCE_REFERENCE' | 'REGISTRATION_PLATE_NUMBER', required — Information code. - EXISTING_INSURANCE_REFERENCE: References to existing or complementary insurance - REGISTRATION_PLATE_NUMBER: vehicle license plate reference
    - `value` string, required — Information value.

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized. The identity of the caller has not been definitely confirmed (invalid issuer, expired token, ...)
- `403` — Forbidden. The identity of the caller is confirmed, however the required access grants are not met (missing scope, unknown client_id, ...)
- `default` — Default response format.

---

[API](https://skmtc.net/axa-assistance/apis/untitled-api.md) · [All operations](https://skmtc.net/axa-assistance/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/axa-assistance/untitled-api/revisions/efe32b811f1d/schema)