Setmore

App · 10 actions

Connect Setmore to manage your account records and automate everyday work.

Actions

ActionWhat it does
Create appointmentCreate an appointment.
Create customerCreate a new customer.
Find customersFetch customers.
Get available slotsGet all available time slots.
Get services in a categoryFetch services by category key.
List appointmentsFetch appointments by date range.
List service categoriesFetch all categories.
List servicesFetch all services.
List staffFetch all staffs.
Update appointment labelUpdate appointment label.

Create appointment

Create an appointment.

Inputs

Staff keystaff_keytextRequired
Unique key of the staff member
Service keyservice_keytextRequired
Unique key of the service
Customer keycustomer_keytextRequired
Unique key of the customer
Start timestart_timedate and timeRequired
Date/time in format yyyy-MM-ddTHH:mmZ (Zulu)
End timeend_timedate and timeRequired
Date/time in format yyyy-MM-ddTHH:mmZ (Zulu)
Commentcommenttext
Additional comments or notes related to the appointment.
Labellabeltext
Label assigned to the appointment for internal tracking.

Outputs

Value.

dataobject
Response from the service.
has_moretrue/false
Whether another page is available.
next_cursortext
Next page cursor; empty when there are no more pages.
Example output
{
  "data": {
    "data": {
      "appointment": {
        "comment": "Test comment",
        "cost": 1000,
        "currency": "USD",
        "customer_key": "cust_ABC123",
        "duration": 60,
        "end_time": "2025-01-20T10:00Z",
        "key": "appt_123456",
        "label": "Test Label",
        "service_key": "svc_ABC123",
        "staff_key": "staff_ABC123",
        "start_time": "2025-01-20T09:00Z",
        "video_meeting_url": "https://video.example.com/meeting/123456"
      }
    },
    "msg": "Appointment created successfully",
    "response": true
  },
  "has_more": false,
  "next_cursor": null
}

Create customer

Create a new customer.

Inputs

First namefirst_nametextRequired
First name of the customer.
Last namelast_nametext
Last name of the customer.
Email IDemail_idtext
Customer email.
Company keycompany_keytext
Unique identifier for the company associated with the customer.
Contact typecontact_typetext
Type of contact.
Country codecountry_codetext
Country dialing code.
Cell phonecell_phonetext
Primary personal contact number.
Work phonework_phonetext
Work contact number.
Home phonehome_phonetext
Home landline contact number.
Addressaddresstext
Address line of the customer.
Citycitytext
City name.
Statestatetext
State name.
Postal codepostal_codetext
Postal / ZIP code.
Image urlimage_urltext
URL for customer's image.
Commentcommenttext
Additional notes / reference.
Additional fieldsadditional_fieldsobject
Arbitrary additional custom fields.

Outputs

Value.

dataobject
Response from the service.
has_moretrue/false
Whether another page is available.
next_cursortext
Next page cursor; empty when there are no more pages.
Example output
{
  "data": {
    "data": {
      "customer": {
        "additional_fields": {},
        "address": "SMALLSYS INC 795 E DRAGRAM",
        "cell_phone": "(000) 000-0000",
        "city": "TUCSON",
        "comment": "Referred by aravinth",
        "company_key": "comp_12345",
        "contact_type": "Customer",
        "country_code": "+1",
        "email_id": "kevin@setmore.com",
        "first_name": "Kevin",
        "home_phone": "(000) 000-0000",
        "image_url": "https://myimages.com/kevin.jpg",
        "key": "cust_12345",
        "last_name": "Payne",
        "postal_code": "85705",
        "state": "AZ",
        "work_phone": "(000) 000-0000"
      }
    },
    "msg": "Customer created successfully",
    "response": true
  },
  "has_more": false,
  "next_cursor": null
}

Find customers

Fetch customers.

Inputs

FirstnamefirstnametextRequired
First name of the customer.
Phonephonetext
Phone number of the customer.
Emailemailtext
Email of the customer.

Outputs

Value.

dataobject
Response from the service.
has_moretrue/false
Whether another page is available.
next_cursortext
Next page cursor; empty when there are no more pages.
Example output
{
  "data": {
    "data": {
      "customer": []
    },
    "msg": "Customers fetched successfully",
    "response": true
  },
  "has_more": false,
  "next_cursor": null
}

Get available slots

Get all available time slots.

Inputs

Staff keystaff_keytextRequired
Staff identifier.
Service keyservice_keytextRequired
Service identifier.
Selected dateselected_datedateRequired
Selected date in DD/MM/YYYY.
Off hoursoff_hourstrue/false
Include off-hours slots.
Double bookingdouble_bookingtrue/false
Allow double booking.
Slot limitslot_limitnumber
Maximum number of slots to return (must be ≤ 30).From 1 to 30.
Timezonetimezonetext
IANA timezone. If omitted, company timezone is used.

Outputs

Value.

dataobject
Response from the service.
has_moretrue/false
Whether another page is available.
next_cursortext
Next page cursor; empty when there are no more pages.
Example output
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}

Get services in a category

Fetch services by category key.

Inputs

Category keycategory_keytextRequired
The key of the service category to fetch.

Outputs

Value.

dataobject
Response from the service.
has_moretrue/false
Whether another page is available.
next_cursortext
Next page cursor; empty when there are no more pages.
Example output
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}

List appointments

Fetch appointments by date range.

Inputs

Start datestart_datedateRequired
Start date for this request.
End dateend_datedateRequired
End date for this request.
Staff keystaff_keytext
Staff key for this request.
Customer detailscustomer_detailstrue/false
Customer details for this request.
Cursorcursortext
Cursor for this request.

Outputs

Value.

dataobject
Response from the service.
has_moretrue/false
Whether another page is available.
next_cursortext
Next page cursor; empty when there are no more pages.
Example output
{
  "data": {
    "data": {
      "appointments": [],
      "cursor": "eyJzdGFydFRpbWUiOj..."
    },
    "response": true
  },
  "has_more": false,
  "next_cursor": null
}

List service categories

Fetch all categories.

Inputs

None.

Outputs

Value.

dataobject
Response from the service.
has_moretrue/false
Whether another page is available.
next_cursortext
Next page cursor; empty when there are no more pages.
Example output
{
  "data": {
    "cursor": "example",
    "data": {
      "service_categories": []
    },
    "msg": "Categories fetched successfully",
    "response": true
  },
  "has_more": false,
  "next_cursor": null
}

List services

Fetch all services.

Inputs

None.

Outputs

Value.

dataobject
Response from the service.
has_moretrue/false
Whether another page is available.
next_cursortext
Next page cursor; empty when there are no more pages.
Example output
{
  "data": {
    "data": {
      "services": []
    },
    "msg": "Services fetched successfully",
    "response": true
  },
  "has_more": false,
  "next_cursor": null
}

List staff

Fetch all staffs.

Inputs

None.

Outputs

Value.

dataobject
Response from the service.
has_moretrue/false
Whether another page is available.
next_cursortext
Next page cursor; empty when there are no more pages.
Example output
{
  "data": {
    "data": {
      "cursor": "cursor123",
      "staffs": []
    },
    "response": true
  },
  "has_more": false,
  "next_cursor": null
}

Update appointment label

Update appointment label.

Inputs

Appointment IDappointment_idtextRequired
Appointment id for this request.
LabellabeltextRequired
Label for this request.

Outputs

Value.

dataobject
Response from the service.
has_moretrue/false
Whether another page is available.
next_cursortext
Next page cursor; empty when there are no more pages.
Example output
{
  "data": {
    "data": {
      "appointment": {
        "comment": "Test comment",
        "cost": 1000,
        "currency": "USD",
        "customer": {},
        "customer_key": "cust_ABC123",
        "duration": 60,
        "end_time": "2025-01-20T10:00Z",
        "key": "appt_123456",
        "label": "Test Label",
        "service_key": "svc_ABC123",
        "staff_key": "staff_ABC123",
        "start_time": "2025-01-20T09:00Z",
        "video_meeting_url": "https://video.example.com/meeting/123456"
      }
    },
    "msg": "Appointment Label updated successfully",
    "response": true
  },
  "has_more": false,
  "next_cursor": null
}

On this page