**Version: 202601**

# Create carrier service

**POST** `/openapi/2026-01/carrier_services`

Enables users to create a new carrier service for calculating shipping rates.

## Request

**application/json**

**Body | Example**

**Body (required)**

- `carrier_service` object (required)

  Carrier service data to create

  - `name` string (required)

    Carrier service name (used as both English and Chinese names internally)
  - `callback_url` string (required)

    Callback URL for shipping rate calculation. Shoplazza will call this URL when calculating rates
  - `carrier_code` string (required)

    Unique code representing the carrier service, for example, "dhl"
  - `active` boolean

    Whether to enable the carrier service
  - `logo` string

    URL of the carrier service's logo
  - `short_desc` string

    Brief description of the carrier service

```json
{
  "carrier_service": {
    "name": "string",
    "callback_url": "string",
    "carrier_code": "string",
    "active": true,
    "logo": "string",
    "short_desc": "string"
  }
}
```

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `carrier_service` object

    The created carrier service

    - `id` string

      Carrier service ID
    - `name` string

      Name of the carrier service
    - `active` boolean

      Whether the carrier service is active
    - `callback_url` string

      Callback URL for rate calculation
    - `scopes` string

      Permission scopes (comma-separated)
    - `carrier_service_code` string

      Carrier service code
    - `logo` string

      Logo URL
    - `short_desc` string

      Brief description of the carrier service
    - `created_at` string

      Creation time, in ISO-8601 format
    - `updated_at` string

      Last update time, in ISO-8601 format

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "carrier_service": {
      "id": "string",
      "name": "string",
      "active": true,
      "callback_url": "string",
      "scopes": "string",
      "carrier_service_code": "string",
      "logo": "string",
      "short_desc": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  }
}
```