Contact

API resource reference for Contact, part of the Notification service. To create or change one, see Changing resources; to inspect, see Reading resources.

This resource is part of the v1alpha1 API and is subject to change. Fields and behavior may change in future releases.

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

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

datumctl apply -f contact.yaml --project my-project
datumctl get contacts --project my-project
datumctl describe contact jane-doe --project my-project

Run datumctl explain contacts --recursive to see the full, live field tree for this resource.

Overview

Concepts

Resource Manager

IAM

Compute

Networking

DNS

IPAM

Quota

Billing

Telemetry

Notification

Platform resources

Identity

Overview

Spec fields

Status fields (read-only)

Usage

​Identity

​Overview

​Spec fields

​Status fields (read-only)

​Usage

Identity

Overview

Spec fields

Status fields (read-only)

Usage