# The Backend Invitation object

The Backend `Invitation` object represents an invitation to join your application.

## Properties

| Property                                     | Type                                                        | Description                                                                                                                                                                                                                                                                                                                                                                                   |
| -------------------------------------------- | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <a id="createdat"></a> `createdAt`           | `number`                                                    | The date when the `Invitation` was first created.                                                                                                                                                                                                                                                                                                                                             |
| <a id="emailaddress"></a> `emailAddress`     | `string`                                                    | The email address that the invitation was sent to.                                                                                                                                                                                                                                                                                                                                            |
| <a id="id"></a> `id`                         | `string`                                                    | The unique identifier for the `Invitation`.                                                                                                                                                                                                                                                                                                                                                   |
| <a id="publicmetadata"></a> `publicMetadata` | <code>null | Record<string, unknown></code>                 | [Metadata](https://clerk.com/docs/reference/types/metadata.md#user-public-metadata){{ target: '_blank' }} that can be read from the Frontend API and [Backend API](https://clerk.com/docs/reference/backend-api){{ target: '_blank' }} and can be set only from the Backend API. Once the user accepts the invitation and signs up, these metadata will end up in the user's public metadata. |
| <a id="revoked"></a> `revoked?`              | `boolean`                                                   | Whether the `Invitation` has been revoked.                                                                                                                                                                                                                                                                                                                                                    |
| <a id="status"></a> `status`                 | `"expired" | "revoked" | "pending" | "accepted"` | The status of the `Invitation`.                                                                                                                                                                                                                                                                                                                                                               |
| <a id="updatedat"></a> `updatedAt`           | `number`                                                    | The date when the `Invitation` was last updated.                                                                                                                                                                                                                                                                                                                                              |
| <a id="url"></a> `url?`                      | `string`                                                    | The URL that the user can use to accept the invitation.                                                                                                                                                                                                                                                                                                                                       |

---

## Sitemap

[Overview of all docs pages](https://clerk.com/docs/llms.txt)