Create Service Level

Beta

POST/v1/operations/carriers/{carrier_id}/service-levels

Idempotent with Idempotency-Key header. Learn more

Creates a service level for a carrier.

carrier_idstring

Carrier ID.

include[]optional arrayenumValues:ownerowner.account

Sub-objects to expand in the response. When omitted, sub-objects are returned as null.

namestring

Display name.

codestring

Service level code.

customer_portal_visibilityoptional stringenumValues:visiblehidden

Customer portal visibility. Defaults to visible.

is_defaultboolean

Default (system-synced) service level.

idstring

Service level ID.

objectstringenumValues:service_level

Resource type identifier.

namestring

Display name.

service_level_tokenstring

Service level token.

customer_portal_visibilitystringenumValues:visiblehidden

Customer portal visibility.

is_defaultboolean

Default service level for the carrier.

ownerobjectExpandablenullable

Owner.

objectstringenumValues:owner

Resource type identifier.

typestringenumValues:systemaccount

The owner type: "system" for platform defaults, "account" for account-owned resources.

accountobjectExpandablenullable

The account that owns this resource. null if the object is system-owned.

idstring

Account ID.

objectstringenumValues:account

Resource type identifier.

namestring

Display name.

default_billing_addressobjectnullable

Default billing address.

Always returned as null in this endpoint.

default_shipping_addressobjectnullable

Default shipping address.

Always returned as null in this endpoint.

brandingobjectnullable

Branding configuration.

Always returned as null in this endpoint.

portalobjectnullable

Portal configuration.

Always returned as null in this endpoint.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

Responses

201

Successful response for Create Service Level

Create Service Level

curl API_HOST/v1/operations/carriers/{carrier_id}/service-levels \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Augno-Version: 1.0.forge-preview.1" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Ground Shipping",
  "code": "ground",
  "is_default": false
}'

curl API_HOST/v1/operations/carriers/{carrier_id}/service-levels \
  -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Augno-Version: 1.0.forge-preview.1" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Ground Shipping",
  "code": "ground",
  "is_default": false
}'

201 example

{
  "id": "crop_01jm4r6700f8nwq3v5hx2d9ktp",
  "object": "service_level",
  "name": "FedEx Ground",
  "service_level_token": "fedex_ground",
  "customer_portal_visibility": "visible",
  "is_default": false,
  "owner": {
    "object": "owner",
    "type": "account",
    "account": {
      "id": "ac_01gf7a8200eaj8fke1xvw4h50x",
      "object": "account",
      "name": "Acme Inc.",
      "default_billing_address": null,
      "default_shipping_address": null,
      "branding": null,
      "portal": null,
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  },
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

{
  "id": "crop_01jm4r6700f8nwq3v5hx2d9ktp",
  "object": "service_level",
  "name": "FedEx Ground",
  "service_level_token": "fedex_ground",
  "customer_portal_visibility": "visible",
  "is_default": false,
  "owner": {
    "object": "owner",
    "type": "account",
    "account": {
      "id": "ac_01gf7a8200eaj8fke1xvw4h50x",
      "object": "account",
      "name": "Acme Inc.",
      "default_billing_address": null,
      "default_shipping_address": null,
      "branding": null,
      "portal": null,
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  },
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

Create Service Level

Path Parameters

Query Parameters

Request Body

Returns

Responses