> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Luma: Post V1 Events Guests Send Invites

> Send guests an invite to an event. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Send guests an invite to an event.

<Info>
  Tool ID: `luma_post_v1_events_guests_send_invites`
</Info>

## Run this action

Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.

```ts theme={null}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'luma_post_v1_events_guests_send_invites',
  {
    "event_id": "event_123",
    "guests": [
      {
        "email": "jane.doe@example.com"
      }
    ]
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={null}
deepline tools execute luma_post_v1_events_guests_send_invites --input '{
  "event_id": "event_123",
  "guests": [
    {
      "email": "jane.doe@example.com"
    }
  ]
}' --json
```

## Example response

The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.

```json theme={null}
{
  "data": {
    "skipped": [
      {
        "email": "jane.doe@example.com"
      }
    ]
  }
}
```

Use `deepline tools get luma_post_v1_events_guests_send_invites --json` for the latest machine-readable contract.

## Input reference

Send guests an invite to an event. We'll send an email, and if their phone number is linked to their Luma account, they'll also receive an SMS. Invites are sent in the background; the response lists any guests that will be skipped because they unsubscribed from your calendar, were removed by an admin, or blocked you.

| Name               | Type     | Required | Default | Details                                                                                                                         |
| ------------------ | -------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `payload.event_id` | `string` | Yes      | —       | Event ID, this usually starts with evt-                                                                                         |
| `payload.guests`   | `array`  | Yes      | —       | Information about the guests you want to invite to the event. If a user already has a name, this will not overwrite their name. |
| `payload.message`  | `string` | No       | —       | Personalize the message that will be included in the invite. Max of 200 characters. Maximum length: 200.                        |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Send guests an invite to an event. We'll send an email, and if their phone number is linked to their Luma account, they'll also receive an SMS. Invites are sent in the background; the response lists any guests that will be skipped because they unsubscribed from your calendar, were removed by an admin, or blocked you.",
    "properties": {
      "event_id": {
        "type": "string",
        "description": "Event ID, this usually starts with evt-"
      },
      "guests": {
        "type": "array",
        "description": "Information about the guests you want to invite to the event. If a user already has a name, this will not overwrite their name.",
        "items": {
          "type": "object",
          "properties": {
            "email": {
              "type": "string"
            },
            "name": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "email"
          ],
          "additionalProperties": false
        }
      },
      "message": {
        "type": [
          "string",
          "null"
        ],
        "description": "Personalize the message that will be included in the invite. Max of 200 characters.",
        "maxLength": 200
      }
    },
    "required": [
      "event_id",
      "guests"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name                          | Type     | Required | Default | Details                                                                                                                                                                                                    |
| ----------------------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `result.data`                 | `object` | Yes      | —       | Provider response payload.                                                                                                                                                                                 |
| `result.data.skipped`         | `array`  | Yes      | —       | Guests that won't be added because they unsubscribed from your calendar, were removed or blocked by a calendar admin, or there is a block between you and them. Everyone else in the request is processed. |
| `result.data.skipped[].email` | `string` | Yes      | —       | —                                                                                                                                                                                                          |
| `result.meta`                 | `object` | No       | —       | Additional response metadata (status, paging).                                                                                                                                                             |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "skipped": {
            "type": "array",
            "description": "Guests that won't be added because they unsubscribed from your calendar, were removed or blocked by a calendar admin, or there is a block between you and them. Everyone else in the request is processed.",
            "items": {
              "type": "object",
              "properties": {
                "email": {
                  "type": "string"
                }
              },
              "required": [
                "email"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "skipped"
        ],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Luma provider guide](/docs/providers/luma/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)