# iCloud Calendar and Contacts

> Discover iCloud calendars and address books; read, create, update and delete events and contacts with conflict protection.

App · 12 actions. Web page: https://docs.lodol.com/docs/integrations/icloud

## Actions

### Create contact

Create contact.

**Inputs**

- Address book url (`address_book_url`, text, required): Choose the address book url or use an ID from a previous step.
- Display name (`display_name`, text, required): Display name.
- Given name (`given_name`, text): Given name.
- Family name (`family_name`, text): Family name.
- Email (`email`, text): Email.
- Phone (`phone`, text): Phone.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "content": "example",
    "display_name": "example",
    "email": "example",
    "etag": "example",
    "family_name": "example",
    "given_name": "example",
    "phone": "example",
    "uid": "example",
    "url": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Create event

Create event.

**Inputs**

- Calendar url (`calendar_url`, text, required): Choose the calendar url or use an ID from a previous step.
- Title (`title`, text, required): Title.
- Start (`start_at`, date and time, required): When the event starts, including the time zone.
- End (`end_at`, date and time, required): When the event ends; must be later than Start.
- Description (`description`, text): Description.
- Location (`location`, text): Location.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "content": "example",
    "description": "example",
    "end_at": "example",
    "etag": "example",
    "location": "example",
    "start_at": "example",
    "title": "example",
    "uid": "example",
    "url": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Delete contact

Delete contact.

**Inputs**

- Contact url (`contact_url`, text, required): Contact url.
- Record version (`etag`, text, required): Use etag from the latest get or update result. A changed record is refused to prevent overwriting someone else’s edits.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

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

### Delete event

Delete event.

**Inputs**

- Event url (`event_url`, text, required): Event url.
- Record version (`etag`, text, required): Use etag from the latest get or update result. A changed record is refused to prevent overwriting someone else’s edits.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

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

### Get contact

Get contact.

**Inputs**

- Contact url (`contact_url`, text, required): Contact url.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "content": "example",
    "display_name": "example",
    "email": "example",
    "etag": "example",
    "family_name": "example",
    "given_name": "example",
    "phone": "example",
    "uid": "example",
    "url": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get event

Get event.

**Inputs**

- Event url (`event_url`, text, required): Event url.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "content": "example",
    "description": "example",
    "end_at": "example",
    "etag": "example",
    "location": "example",
    "start_at": "example",
    "title": "example",
    "uid": "example",
    "url": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### List address books

List address books.

**Inputs**: None.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

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

### List calendars

List calendars.

**Inputs**: None.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

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

### List contacts

List contacts.

**Inputs**

- Address book url (`address_book_url`, text, required): Choose the address book url or use an ID from a previous step.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

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

### List events

List events.

**Inputs**

- Calendar url (`calendar_url`, text, required): Choose the calendar url or use an ID from a previous step.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

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

### Update contact

Update contact.

**Inputs**

- Contact url (`contact_url`, text, required): Contact url.
- Record version (`etag`, text, required): Use etag from the latest get or update result. A changed record is refused to prevent overwriting someone else’s edits.
- Display name (`display_name`, text): Display name.
- Given name (`given_name`, text): Given name.
- Family name (`family_name`, text): Family name.
- Email (`email`, text): Email.
- Phone (`phone`, text): Phone.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "content": "example",
    "display_name": "example",
    "email": "example",
    "etag": "example",
    "family_name": "example",
    "given_name": "example",
    "phone": "example",
    "uid": "example",
    "url": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Update event

Update event.

**Inputs**

- Event url (`event_url`, text, required): Event url.
- Record version (`etag`, text, required): Use etag from the latest get or update result. A changed record is refused to prevent overwriting someone else’s edits.
- Title (`title`, text): Title.
- Start (`start_at`, date and time): When the event starts, including the time zone.
- End (`end_at`, date and time): When the event ends; must be later than Start.
- Description (`description`, text): Description.
- Location (`location`, text): Location.

**Outputs**

- `data` (object): Service response or returned records.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Cursor for the next page; empty when finished.

**Example output**

```json
{
  "data": {
    "content": "example",
    "description": "example",
    "end_at": "example",
    "etag": "example",
    "location": "example",
    "start_at": "example",
    "title": "example",
    "uid": "example",
    "url": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```
