Skip to content

domains

CreateDomainRequest

Bases: TypedDict

Request body for registering a domain.

Source code in nylas/models/domains.py 
24
25
26
27
28
class CreateDomainRequest(TypedDict):
    """Request body for registering a domain."""

    name: str
    domain_address: str

Domain dataclass

A domain registered for Transactional Send or Nylas Inbound.

Source code in nylas/models/domains.py 
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
@dataclass_json
@dataclass
class Domain:
    """
    A domain registered for Transactional Send or Nylas Inbound.
    """

    id: str
    name: str
    branded: bool
    domain_address: str
    organization_id: str
    region: str
    verified_ownership: bool
    verified_dkim: bool
    verified_spf: bool
    verified_mx: bool
    verified_feedback: bool
    verified_dmarc: bool
    verified_arc: bool
    created_at: int
    updated_at: int

DomainVerificationAttempt dataclass

DNS verification attempt or required records for a verification type.

Source code in nylas/models/domains.py 
73
74
75
76
77
78
79
80
81
82
83
84
85
86
@dataclass_json
@dataclass
class DomainVerificationAttempt:
    """
    DNS verification attempt or required records for a verification type.
    """

    verification_type: Optional[str] = field(
        default=None, metadata=config(field_name="type")
    )
    options: Optional[Any] = None
    host: Optional[str] = None
    value: Optional[str] = None
    status: Optional[str] = None

DomainVerificationDetails dataclass

Response data from get domain info or verify domain endpoints.

Source code in nylas/models/domains.py 
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
@dataclass_json
@dataclass
class DomainVerificationDetails:
    """
    Response data from get domain info or verify domain endpoints.
    """

    domain_id: str
    attempt: Optional[DomainVerificationAttempt] = None
    created_at: Optional[int] = None
    expires_at: Optional[int] = None
    message: Optional[str] = None

GetDomainInfoRequest

Bases: TypedDict

Request body for retrieving DNS records for a verification type.

Source code in nylas/models/domains.py 
37
38
39
40
class GetDomainInfoRequest(TypedDict):
    """Request body for retrieving DNS records for a verification type."""

    type: DomainVerificationType

ListDomainsQueryParams

Bases: ListQueryParams

Query parameters for listing domains.

Attributes:

Name Type Description
limit

Maximum number of objects to return.
page_token

Cursor for the next page (from next_cursor on the previous response).
Source code in nylas/models/domains.py 
12
13
14
15
16
17
18
19
20
21
class ListDomainsQueryParams(ListQueryParams):
    """
    Query parameters for listing domains.

    Attributes:
        limit: Maximum number of objects to return.
        page_token: Cursor for the next page (from ``next_cursor`` on the previous response).
    """

    pass

UpdateDomainRequest

Bases: TypedDict

Request body for updating a domain (currently only name is supported).

Source code in nylas/models/domains.py 
31
32
33
34
class UpdateDomainRequest(TypedDict, total=False):
    """Request body for updating a domain (currently only ``name`` is supported)."""

    name: str

VerifyDomainRequest

Bases: TypedDict

Request body for triggering DNS verification.

Source code in nylas/models/domains.py 
43
44
45
46
class VerifyDomainRequest(TypedDict):
    """Request body for triggering DNS verification."""

    type: DomainVerificationType