# Create custom region coverage profile

Creates a custom region coverage profile using a list of ISO 2-letter country codes.

Validation checks:

The system performs the following validations before creating the profile:
- Duplicate name check: If a region with the same name already exists for this organization, returns 400 Bad Request
- Duplicate coverage check: If a coverage profile with the exact same set of countries already exists, returns 409 Conflict with the existing profile details

Note: Coverage profiles are immutable and cannot be deleted. You can only create new profiles.

Endpoint: POST /v3/coverage-profiles/custom-region
Version: 1.0.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `region_name` (string, required)
    The name of the custom region.
    Example: "Usa and Mexico Regional Plan"

  - `label` (string, required)
    Enum: "Green", "Aqua", "Blue", "Voilet", "Red", "Grey", "Orange"

  - `iso2_list` (array, required)
    List of ISO 2-letter country codes included in the custom region.
    Example: ["US","MX"]

## Response 200 fields (application/json):

  - `error` (boolean, required)
    Indicates whether an error occurred during the request

  - `data` (object, required)

  - `data.coverage_id` (string, required)
    The unique identifier for the coverage profile
    Example: "85089a51-801c-4737-bd8b-f542705712bf"

  - `data.region_code` (string, required)
    The generated region code for the custom region
    Example: "R33BHT"

  - `data.region_name` (string, required)
    The name of the custom region
    Example: "Usa and Mexico Regional Plan"

  - `data.iso2_list` (array, required)
    List of ISO 2-letter country codes included in the custom region
    Example: ["US","MX"]

## Response 400 fields (application/json):

  - `error` (boolean, required)
    Example: true

  - `message` (string, required)
    Example: "Custom region with this name already exists for this organization"

  - `missing_iso2` (array)
    List of ISO2 country codes from the request for which no operators were found.

## Response 401 fields (application/json):

  - `error` (boolean, required)
    Indicates whether an error occurred during the request
    Example: true

  - `message` (string, required)
    Error message describing the unauthorized access
    Example: "Unauthorized: API key is missing"

## Response 409 fields (application/json):

  - `error` (boolean, required)
    Example: true

  - `message` (string, required)
    Example: "Coverage id with same operator already exists"

  - `existing_coverage` (object, required)

  - `existing_coverage.coverage_id` (string, required)
    Example: "85089a51-801c-4737-bd8b-f542705712bf"

  - `existing_coverage.region_code` (string, required)
    Example: "R33BHT"

  - `existing_coverage.region_name` (string, required)
    Example: "TEST USA and Mexico"

  - `existing_coverage.iso2_list` (array, required)
    Example: ["US","MX"]