Home > Agendize Scheduling

Services


Resource representation

{ "id": {string}, "name": {string}, "duration": {integer}, "bufferDuration": {integer}, "price": {float}, "payable": {boolean}, "color": {color}, "description": {string}, "picture": { "url": {string}, "mimeType": {string} }, "staff": [ { "id": {string}, "firstName": {string}, "lastName": {string}, "price": {string} } ], "availableForWidget": {boolean}, "maxAppointmentsPerDay": {integer}, "externalId": {string} }
Parameter name Value Description
id string Identifier of the service.
name string Name of the service. writable
duration integer Service duration, in minutes. writable
bufferDuration integer Service buffer duration, in minutes. writable
price float Service pricing. writable
payable boolean Sets if the client can pay with paypal. writable
color string Service color, for dashboard displaying. Hexadecimal web color. Default Color: #EFEFEF. writable
description string Description of the service. writable
staff list List of staff members who have the skills for the service. writable
picture object Service picture url and mime type. writable
picture.url string Url of the service picture.
picture.mimeType string Mime type of the service picture file. writable
availableForWidget boolean Sets if the service is available for online scheduling. Default value: true writable
maxAppointmentsPerDay boolean Sets how many appointments a client can book per day. Default value: 0 (no limit) writable
externalId string Unique service identifier from another (external) system.

Delete

Deletes an entry on the company's service list.

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

DELETE http://selfserv.agendize.com/api/2.1/scheduling/companies/{companyId}/services/{serviceId}

Parameters

Parameter name Value Description
Path parameters
companyId string Company identifier.
serviceId string Service identifier or external id of service.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns an empty response body.


Get

Returns an entry of the company's service list.

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

GET http://selfserv.agendize.com/api/2.1/scheduling/companies/{companyId}/services/{serviceId}

Parameters

Parameter name Value Description
Path parameters
companyId string Company identifier.
serviceId string Service identifier or external id of service.
Optional query parameters
fields string Specify the fields returned. Comma seperated field names (ex: "id,name").

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a Service resource in the response body.


List

Returns entries on the company's service list.

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

GET http://selfserv.agendize.com/api/2.1/scheduling/companies/{companyId}/services

Parameters

Parameter name Value Description
Path parameters
companyId string Company identifier.
Optional query parameters
showDeleted boolean Whether to include deleted company list entries in the result. Optional. The default is false.
syncToken string Token obtained from the nextSyncToken field returned on the last page of results from the previous list request.
fields string Specify the fields returned. Comma seperated field names (ex: "id,name").
orderBy string Order list by:
  • name[a-z]
  • name[z-a]
  • duration[0-100]
  • duration[100-0]
  • price[0-100
  • price[100-0]
  • widgetSettings. Sort services as defined in widget settings.
  • Or define the service list, separted with commas.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response body with the following structure:

{ items: [Service Resource] }

Insert

Adds an entry to the company's service list.

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

POST http://selfserv.agendize.com/api/2.1/scheduling/companies/{companyId}/services

Parameters

Parameter name Value Description
Path parameters
companyId string Company identifier.

Request body

In the request body, supply a Service resource with the following properties:

Parameter name Value Description
Required Properties
name string Name of the service.
Optional Properties
duration integer Service duration, in minutes. The default duration is 60 minutes.
bufferDuration integer Service buffer duration, in minutes. The default buffer duration is 0 minute.
price float Service pricing. Default price is 0.
payable boolean Sets if the client can pay with paypal. The default value is false.
color string Service color, for dashboard displaying. Format: xxxxxx. The default value is EFEFEF.
description string Description of the service.
staff list List of staff members who have the skills for the service.
picture object Service picture url and mime type.
picture.url string Url of the service picture.
picture.mimeType string Mime type of the service picture file.
availableForWidget boolean Sets if the service is available for online scheduling. Default value: true
maxAppointmentsPerDay boolean Sets how many appointments a client can book per day. Default value: 0 (no limit)

Response

If successful, this method returns a Service resource in the response body.


Update

Updates an entry on the company's service list.

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

PUT http://selfserv.agendize.com/api/2.1/scheduling/companies/{companyId}/services/{serviceId}

Parameters

Parameter name Value Description
Path parameters
companyId string Company identifier.
serviceId string Service identifier or external id of service.

Request body

In the request body, supply a Service resource with the following properties:

Parameter name Value Description
Optional Properties
name string Name of the service.

Response

If successful, this method returns a Service resource in the response body.


Watch

Watch for changes to Service resources.

Authentication is required to execute this request. Please refer to Authentication for more.

The watch send an Service resource in the request body

Request

HTTP Request

POST http://selfserv.agendize.com/api/2.1/scheduling/companies/{companyId}/services/watch

Parameters

Parameter name Value Description
Path parameters
companyId string Company identifier.

Request body

{ "address": {string}, "basicAuth": { "username": {string}, "password": {string} }, "httpRequestHeader": { (name): {string} } }
Required Properties
address string The address where notifications are delivered for this watch.
Optional Properties
basicAuth string Credentials parameters for HTTP Basic authentication on the destination watch address. Only if you use this authentication method.
basicAuth.username string Username.
basicAuth.password string Password.
httpRequestHeader string Custom header parameters to send with the http request on the destination watch address.
httpRequestHeader.name string header parameter name.

Response

If successful, this method returns an of Watch resource in the response body.

Watch event supported

  • Service added in dashboard.
  • Service modified in dashboard.
  • Service delete in dashboard. In this case, the watch request add the following header propert in http request:
    X-Agendize-objectEvent: deleted