Skip to content

List sending addresses

GET
/api/v1/email-sending/addresses
curl --request GET \
--url https://digize.com/api/v1/email-sending/addresses \
--header 'x-api-key: <x-api-key>'

The addresses the workspace sends from, each with its from name, reply-to and signature, what it sends, and where replies to it go.

Needs the sites:read permission.

Done

Media typeapplication/json
Array<object>
object
id
required
string
address
required
string
domain
required
string
name
required
string
replyTo
required
string | null
signature
required
string
ready
required
boolean
isDefault
required
boolean
purposes
required
Array<string>
Allowed values: conversation receipt booking invoice review_request automation abandoned_cart
replies
required
string
Allowed values: conversations elsewhere nowhere
createdAt
required
string format: date-time

Example

[
{
"purposes": [
"conversation"
],
"replies": "conversations"
}
]

What was sent isn’t valid (invalid).

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal
message
required
string
details
object
key
additional properties
any

Example

{
"error": {
"code": "invalid"
}
}

No key, or one that’s unknown, off or expired.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal
message
required
string
details
object
key
additional properties
any

Example

{
"error": {
"code": "invalid"
}
}

The key doesn’t have the permission this needs.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal
message
required
string
details
object
key
additional properties
any

Example

{
"error": {
"code": "invalid"
}
}

Nothing has that id (not_found).

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal
message
required
string
details
object
key
additional properties
any

Example

{
"error": {
"code": "invalid"
}
}

Over the rate limit; see retry-after.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal
message
required
string
details
object
key
additional properties
any

Example

{
"error": {
"code": "invalid"
}
}