> ## Documentation Index
> Fetch the complete documentation index at: https://datum-4926dda5-docs-api-reference-demo.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Contact

> Contact is the Schema for the contacts API. It represents a contact for a user.

<Note>
  API resource reference for **Contact**, part of the [Notification service](/api/notification/overview). To create or change one, see [Changing resources](/datumctl/resources/changing); to inspect, see [Reading resources](/datumctl/resources/reading).
</Note>

<Warning>
  This resource is part of the `v1alpha1` API and is subject to change. Fields and behavior may change in future releases.
</Warning>

## Identity

|         |                             |
| ------- | --------------------------- |
| Group   | `notification.miloapis.com` |
| Version | `v1alpha1`                  |
| Kind    | `Contact`                   |
| Scope   | Project                     |

## Overview

A `Contact` represents a person who can receive notifications from Datum Cloud, tied to a user subject. Use it to register the name and email address that Datum Cloud (and its downstream notification providers) should use when reaching out to a user within a Project.

## Spec fields

| Field                    | Type   | Required | Description                                                                                                      |
| ------------------------ | ------ | -------- | ---------------------------------------------------------------------------------------------------------------- |
| `spec.email`             | string | Yes      | The email address for the contact.                                                                               |
| `spec.givenName`         | string | No       | The contact's given (first) name.                                                                                |
| `spec.familyName`        | string | No       | The contact's family (last) name.                                                                                |
| `spec.subject`           | Object | No       | Reference to the subject the contact belongs to.                                                                 |
| `spec.subject.apiGroup`  | string | Yes      | API group of the referenced subject. Must be `iam.miloapis.com`.                                                 |
| `spec.subject.kind`      | string | Yes      | Type of subject being referenced. Must be `User`.                                                                |
| `spec.subject.name`      | string | Yes      | Name of the referenced subject.                                                                                  |
| `spec.subject.namespace` | string | No       | Namespace of the referenced subject. Required for Project-scoped subjects; omitted for Platform-scoped subjects. |

## Status fields (read-only)

| Field               | Type      | Description                                                                                                                                   |
| ------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `status.conditions` | \[]Object | Latest observations of the contact's state. The standard `Ready` condition tracks contact creation and sync to the contact provider.          |
| `status.providers`  | \[]Object | Per-provider status for this contact, enabling multiple provider backends to be tracked simultaneously.                                       |
| `status.providerID` | string    | Identifier returned by the underlying contact provider (e.g. Resend) when the contact is created. Deprecated: use `status.providers` instead. |

## Usage

```yaml theme={null}
apiVersion: notification.miloapis.com/v1alpha1
kind: Contact
metadata:
  name: jane-doe
spec:
  email: jane.doe@example.com
  givenName: Jane
  familyName: Doe
  subject:
    apiGroup: iam.miloapis.com
    kind: User
    name: jane-doe
```

```bash theme={null}
datumctl apply -f contact.yaml --project my-project
datumctl get contacts --project my-project
datumctl describe contact jane-doe --project my-project
```

<Tip>
  Run `datumctl explain contacts --recursive` to see the full, live field tree for this resource.
</Tip>