Skip to main content
POST
/
services
Create a new service
curl --request POST \
  --url https://api.guile.app/services \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Skin Fade",
  "bundledAddOns": [
    {
      "id": "service-123",
      "name": "Beard Trim"
    }
  ],
  "visibility": "visible",
  "categories": [
    {
      "id": "afada02b-e9fe",
      "name": "Shaving"
    }
  ],
  "description": "Expertly transitioned fade with optional designs on the side.",
  "duration": "PT30M",
  "cost": "45.00",
  "addOn": {
    "duration": "PT30M",
    "cost": "45.00"
  }
}
'
{
  "name": "Skin Fade",
  "bundledAddOns": [
    {
      "id": "service-123",
      "name": "Beard Trim"
    }
  ],
  "visibility": "visible",
  "categories": [
    {
      "id": "afada02b-e9fe",
      "name": "Shaving"
    }
  ],
  "description": "Expertly transitioned fade with optional designs on the side.",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "duration": "PT30M",
  "cost": "45.00",
  "addOn": {
    "duration": "PT30M",
    "cost": "45.00"
  }
}

Body

application/json

Properties for creating a new service for a barber.

A service can be configured as a base service, add-on, or bundle. When configured as a bundle, the service cannot be configured as an add-on or included in another bundle.

Services that are not bundles and have configurations for being used as a base service, an add-on, or both.

​
name
string
required

The display name for this service.

Example:

"Skin Fade"

​
bundledAddOns
object[]
required

Additional add-on services included in this service bundle.

Example:
[
  { "id": "service-123", "name": "Beard Trim" }
]
​
visibility
enum<string>
required

The visibility of the service. Hidden services are not visible to customers.

Available options:
visible,
hidden
​
categories
object[]
required

The categories for this service.

Example:
[
  { "id": "afada02b-e9fe", "name": "Shaving" }
]
​
description
string
required

The description of this service.

Maximum string length: 500
Example:

"Expertly transitioned fade with optional designs on the side."

​
duration
string<duration>

The duration of the service.

Example:

"PT30M"

​
cost
string<decimal>

The cost of the service, excluding any fees or taxes.

Example:

"45.00"

​
addOn
object

If set, the configuration for this service when used as an add-on.

Response

Created.

Representation of a service performed by a barber.

​
name
string
required

The display name for this service.

Example:

"Skin Fade"

​
bundledAddOns
object[]
required

Additional add-on services included in this service bundle.

Example:
[
  { "id": "service-123", "name": "Beard Trim" }
]
​
visibility
enum<string>
required

The visibility of the service. Hidden services are not visible to customers.

Available options:
visible,
hidden
​
categories
object[]
required

The categories for this service.

Example:
[
  { "id": "afada02b-e9fe", "name": "Shaving" }
]
​
description
string
required

The description of this service.

Maximum string length: 500
Example:

"Expertly transitioned fade with optional designs on the side."

​
id
string<uuid>
required

The unique identifier for this service.

​
createdAt
string<date-time>
required

The date-time when this resource was created, in RFC 3339 date-time YYYY-MM-DDThh:mm:ss.sssZ format, UTC. This is derived and immutable.

​
updatedAt
string<date-time>
required

The date-time when this resource was updated, in RFC 3339 date-time YYYY-MM-DDThh:mm:ss.sssZ format, UTC. This is derived and immutable.

​
duration
string<duration>

The duration of the service.

Example:

"PT30M"

​
cost
string<decimal>

The cost of the service, excluding any fees or taxes.

Example:

"45.00"

​
addOn
object

If set, the configuration for this service when used as an add-on.