Create Custom Service - Serval Documentation

POST

custom-services

Create Custom Service

curl --request POST \
  --url https://public.api.serval.com/v2/custom-services \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "teamId": "<string>",
  "name": "<string>",
  "domain": "<string>"
}
'

{
  "data": {
    "id": "<string>",
    "teamId": "<string>",
    "name": "<string>",
    "domain": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

teamId

string

The ID of the team.

name

string

The name of the custom service (e.g., "Internal HR System").

domain

string

The domain for branding/logo lookup (e.g., "hr.company.com").

Response

Success

data

data · object

The created custom service.

Show child attributes

⌘I

Create Custom Service

curl --request POST \
  --url https://public.api.serval.com/v2/custom-services \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "teamId": "<string>",
  "name": "<string>",
  "domain": "<string>"
}
'

{
  "data": {
    "id": "<string>",
    "teamId": "<string>",
    "name": "<string>",
    "domain": "<string>"
  }
}