# Setmore

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

App · 10 actions. Web page: https://docs.lodol.com/docs/integrations/setmore

## Actions

### Create appointment

Create an appointment.

**Inputs**

- Staff key (`staff_key`, text, required): Unique key of the staff member
- Service key (`service_key`, text, required): Unique key of the service
- Customer key (`customer_key`, text, required): Unique key of the customer
- Start time (`start_time`, date and time, required): Date/time in format yyyy-MM-ddTHH:mmZ (Zulu)
- End time (`end_time`, date and time, required): Date/time in format yyyy-MM-ddTHH:mmZ (Zulu)
- Comment (`comment`, text): Additional comments or notes related to the appointment.
- Label (`label`, text): Label assigned to the appointment for internal tracking.

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "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_name`, text, required): First name of the customer.
- Last name (`last_name`, text): Last name of the customer.
- Email ID (`email_id`, text): Customer email.
- Company key (`company_key`, text): Unique identifier for the company associated with the customer.
- Contact type (`contact_type`, text): Type of contact.
- Country code (`country_code`, text): Country dialing code.
- Cell phone (`cell_phone`, text): Primary personal contact number.
- Work phone (`work_phone`, text): Work contact number.
- Home phone (`home_phone`, text): Home landline contact number.
- Address (`address`, text): Address line of the customer.
- City (`city`, text): City name.
- State (`state`, text): State name.
- Postal code (`postal_code`, text): Postal / ZIP code.
- Image url (`image_url`, text): URL for customer's image.
- Comment (`comment`, text): Additional notes / reference.
- Additional fields (`additional_fields`, object): Arbitrary additional custom fields.

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "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 (`firstname`, text, required): First name of the customer.
- Phone (`phone`, text): Phone number of the customer.
- Email (`email`, text): Email of the customer.

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "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_key`, text, required): Staff identifier.
- Service key (`service_key`, text, required): Service identifier.
- Selected date (`selected_date`, date, required): Selected date in DD/MM/YYYY.
- Off hours (`off_hours`, true/false): Include off-hours slots.
- Double booking (`double_booking`, true/false): Allow double booking.
- Slot limit (`slot_limit`, number): Maximum number of slots to return (must be ≤ 30). From 1 to 30.
- Timezone (`timezone`, text): IANA timezone. If omitted, company timezone is used.

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Get services in a category

Fetch services by category key.

**Inputs**

- Category key (`category_key`, text, required): The key of the service category to fetch.

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List appointments

Fetch appointments by date range.

**Inputs**

- Start date (`start_date`, date, required): Start date for this request.
- End date (`end_date`, date, required): End date for this request.
- Staff key (`staff_key`, text): Staff key for this request.
- Customer details (`customer_details`, true/false): Customer details for this request.
- Cursor (`cursor`, text): Cursor for this request.

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "data": {
      "appointments": [],
      "cursor": "eyJzdGFydFRpbWUiOj..."
    },
    "response": true
  },
  "has_more": false,
  "next_cursor": null
}
```

### List service categories

Fetch all categories.

**Inputs**: None.

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "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.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "data": {
      "services": []
    },
    "msg": "Services fetched successfully",
    "response": true
  },
  "has_more": false,
  "next_cursor": null
}
```

### List staff

Fetch all staffs.

**Inputs**: None.

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "data": {
    "data": {
      "cursor": "cursor123",
      "staffs": []
    },
    "response": true
  },
  "has_more": false,
  "next_cursor": null
}
```

### Update appointment label

Update appointment label.

**Inputs**

- Appointment ID (`appointment_id`, text, required): Appointment id for this request.
- Label (`label`, text, required): Label for this request.

**Outputs**: Value.

- `data` (object): Response from the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Next page cursor; empty when there are no more pages.

**Example output**

```json
{
  "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
}
```
