Create a service

Request

Creates a service in the Location catalog. Link Team Members inline through team_members[] — a service without at least one bookable Team Member link does not appear in availability search. Requires Idempotency-Key.

Service packages (complex services made of multiple simple services) are created through this same operation: send type: package with a package block listing the components.

Security

OAuth2(Required scopes: services:write) or RestrictedKey

Path

location_idintegerrequired

Identifier of the Location. Verified against the credential on every call — a Location the credential cannot access responds with 404.

Idempotency-Keystring, <= 255 charactersrequired

Client-generated unique key for this logical request (UUID recommended). A retry with the same key and body returns the original result; the same key with a different body fails with 409 idempotency_key_reused. Keys are retained at least 24 hours and are scoped to credential, Location, and operation; after expiry the value may be reused for a new logical request.

Bodyapplication/jsonrequired

namestringrequired

category_idintegerrequired

typestringrequired

Service kind. Immutable after creation.

Value:"simple"

Example:"simple"

Discriminator

duration_secondsinteger

team_membersArray of objects(ServiceTeamMemberLink)

price_minorinteger

Integer minor units of the Location currency.

curl -i -X POST \
  'https://developer.alteg.io/_mock/en/b2b-v3/openapi/locations/{location_id}/services' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: string' \
  -d '{
    "name": "Men'\''s haircut",
    "category_id": 205,
    "type": "simple",
    "duration_seconds": 3600,
    "team_members": [
      {
        "team_member_id": 321
      },
      {
        "team_member_id": 322,
        "duration_seconds": 2700,
        "price_minor": 300000
      }
    ],
    "price_minor": 250000
  }'

Responses

The created service.

Headers

RateLimit-Remaininginteger, (int32), >= 0

Requests left in the most constrained policy window that applies to this request.

RateLimit-Resetinteger, (int32), >= 0

On 429, seconds until the most constrained policy frees up; it equals Retry-After there. On a successful response it reports the length of that policy's window rather than the time left in the current one, so treat it as the window size, not as a countdown — the counter to pace against is RateLimit-Remaining.

RateLimit-Policystring

Most constrained policy applied to the request, as <limit>;w=<window in seconds>.

Example:"10;w=60"

Locationstring

URL of the created resource.

ETagstring

Version tag of the returned resource. Send it back in If-Match on the next PATCH or DELETE.

X-Request-Idstring

Request identifier for support and log correlation.

Bodyapplication/json

idintegerread-onlyrequired

objectstringread-onlyrequired

Value:"service"

typestringrequired

Service kind. Immutable after creation (422 field_immutable). A package service bundles several simple services of the same Location; it appears in the same list and is scheduled by the same service_id.

Default:"simple"

Enum:"simple""package"

namestringrequired

category_idintegerrequired

Service category (listServiceCategories).

duration_secondsintegerrequired

Default duration in seconds.

price_minorintegerrequired

Default price in integer minor units of the Location currency.

currencystringread-onlyrequired

ISO 4217, server-controlled by the Location.

packageobject(ServicePackageDetails)

Package settings and components. Present only when type is package.

is_bookablebooleanread-only

Derived — true when the service has at least one bookable Team Member link.

team_membersArray of objects(ServiceTeamMemberLink)

Team Members providing this service, with optional per-member overrides.

created_atstring, (date-time)read-only

UTC.

updated_atstring, (date-time)read-only