Create service

Creates a new service in the catalog. If a service with the same external_id already exists, it will be updated instead.

POST /v1/businesses/{businessId}/catalog/services

Create service

cURL

curl --request POST \
  --url https://sandbox.layerfi.com/v1/businesses/{businessId}/catalog/services \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "external_id": "<string>",
  "account_identifier": {
    "type": "AccountId",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "billable_rate_per_minute_amount": 123,
  "memo": "<string>",
  "metadata": {}
}
'

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "business_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "external_id": "<string>",
  "account_identifier": {
    "type": "AccountId",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "ledger_account": {
    "id": {
      "type": "AccountId",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "name": "Current Assets",
    "account_number": "4000",
    "stable_name": {
      "type": "StableName",
      "stable_name": "CURRENT_ASSETS"
    },
    "normality": "CREDIT",
    "account_type": {
      "value": "ASSET",
      "display_name": "Asset"
    },
    "account_subtype": {
      "value": "BANK_ACCOUNTS",
      "display_name": "Current Assets"
    }
  },
  "billable_rate_per_minute_amount": 123,
  "memo": "<string>",
  "metadata": {},
  "deleted_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

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

Path Parameters

businessId · string<uuid> · required

The UUID of the business.

Body

application/json

name · string · required

The name of the service.

external_id · string | null

An optional external identifier for the service. If provided and a service with this external_id already exists, the existing service will be updated instead of creating a new one.

account_identifier · Account ID · object

The ledger account identifier for revenue tracking.

Account ID

Account Stable Name

Show child attributes

billable_rate_per_minute_amount · integer<int64> | null

The billable rate per minute for this service in cents (e.g., 100 = $1.00 per minute or $60.00 per hour).

memo · string | null

Optional memo or notes about the service.

metadata · object

Custom metadata for the service.

Response

200

application/json

Service already exists and was updated.

id · string<uuid> · required

The unique identifier of the service.

business_id · string<uuid> · required

The UUID of the business this service belongs to.

name · string · required

The name of the service.

created_at · string<date-time> · required

Timestamp when the service was created.

updated_at · string<date-time> · required

Timestamp when the service was last updated.

external_id · string | null

An optional external identifier for the service, used for idempotency.

account_identifier · Account ID · object

The ledger account identifier for revenue tracking.

Account ID

Account Stable Name

Show child attributes

ledger_account · object

The ledger account associated with this service.

Show child attributes

billable_rate_per_minute_amount · integer<int64> | null

The billable rate per minute for this service in cents (e.g., 100 = $1.00 per minute or $60.00 per hour).

memo · string | null

Optional memo or notes about the service.

metadata · object

Custom metadata for the service.

deleted_at · string<date-time> | null

Timestamp when the service was deleted, or null if not deleted.