Setmore
App · 10 actions
Connect Setmore to manage your account records and automate everyday work.
Actions
| Action | What it does |
|---|---|
| Create appointment | Create an appointment. |
| Create customer | Create a new customer. |
| Find customers | Fetch customers. |
| Get available slots | Get all available time slots. |
| Get services in a category | Fetch services by category key. |
| List appointments | Fetch appointments by date range. |
| List service categories | Fetch all categories. |
| List services | Fetch all services. |
| List staff | Fetch all staffs. |
| Update appointment label | Update appointment label. |
Create appointment
Create an appointment.
Inputs
- Staff key
staff_keytextRequired - Unique key of the staff member
- Service key
service_keytextRequired - Unique key of the service
- Customer key
customer_keytextRequired - Unique key of the customer
- Start time
start_timedate and timeRequired - Date/time in format yyyy-MM-ddTHH:mmZ (Zulu)
- End time
end_timedate and timeRequired - Date/time in format yyyy-MM-ddTHH:mmZ (Zulu)
- Comment
commenttext - Additional comments or notes related to the appointment.
- Label
labeltext - 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 name
first_nametextRequired - First name of the customer.
- Last name
last_nametext - Last name of the customer.
- Email ID
email_idtext - Customer email.
- Company key
company_keytext - Unique identifier for the company associated with the customer.
- Contact type
contact_typetext - Type of contact.
- Country code
country_codetext - Country dialing code.
- Cell phone
cell_phonetext - Primary personal contact number.
- Work phone
work_phonetext - Work contact number.
- Home phone
home_phonetext - Home landline contact number.
- Address
addresstext - Address line of the customer.
- City
citytext - City name.
- State
statetext - State name.
- Postal code
postal_codetext - Postal / ZIP code.
- Image url
image_urltext - URL for customer's image.
- Comment
commenttext - Additional notes / reference.
- Additional fields
additional_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
- Firstname
firstnametextRequired - First name of the customer.
- Phone
phonetext - Phone number of the customer.
- Email
emailtext - 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 key
staff_keytextRequired - Staff identifier.
- Service key
service_keytextRequired - Service identifier.
- Selected date
selected_datedateRequired - Selected date in DD/MM/YYYY.
- Off hours
off_hourstrue/false - Include off-hours slots.
- Double booking
double_bookingtrue/false - Allow double booking.
- Slot limit
slot_limitnumber - Maximum number of slots to return (must be ≤ 30).From 1 to 30.
- Timezone
timezonetext - 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 key
category_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 date
start_datedateRequired - Start date for this request.
- End date
end_datedateRequired - End date for this request.
- Staff key
staff_keytext - Staff key for this request.
- Customer details
customer_detailstrue/false - Customer details for this request.
- Cursor
cursortext - 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 ID
appointment_idtextRequired - Appointment id for this request.
- Label
labeltextRequired - 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
}