Issue a new intake address and retire every earlier one (ADMIN+)

POST

/organizations/current/inbound-email/regenerate

curl --request POST \
  --url https://api.invogi.com/v1/organizations/current/inbound-email/regenerate \
  --header 'Authorization: Bearer <token>'

Audited. The previous address, including one from an earlier token format, stops accepting mail immediately.

Authorizations

• bearerAuth

Responses

200

The new intake address

Media typeapplication/json

object

address

required

string format: email

statementsAddress

Supplier statements address on the same token, e.g. statements+k7m2q9xbw4t6v8yz@inbound.invogi.com; statements sent here go to /statements

string format: email

Example ^generated

{
  "address": "hello@example.com",
  "statementsAddress": "hello@example.com"
}

401

Missing or invalid API key

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED

message

required

string

request_id

required

string

Example

{
  "error": {
    "code": "NOT_FOUND"
  }
}

403

API key lacks required scope/role

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED

message

required

string

request_id

required

string

Example

{
  "error": {
    "code": "NOT_FOUND"
  }
}