Email Domain Set

get

Authorizations

Path parameters

idintegerRequired

Responses

get

HTTPcURLJavaScriptPython

GET /api/v1/email_domain_sets/{id}/promotions HTTP/1.1
Host: replace_me
Authorization: YOUR_API_KEY
Accept: */*

200

List promotions by email domain set

{
  "promotions": [
    {
      "id": 1,
      "account_id": 28,
      "product_id": null,
      "product_title": null,
      "account_name": "Domain Account 36",
      "currency": "USD",
      "amount": "10.0",
      "discount_type": "flat",
      "code": "PROMO1",
      "name": "Product 1",
      "description": null,
      "active": false,
      "start_date": null,
      "end_date": null,
      "created_at": "2025/03/28 13:11:23 +0000",
      "updated_at": "2025/03/28 13:11:23 +0000",
      "deleted_at": null,
      "usage_type": "once-per-user",
      "canvas_root_account_uuid": "36WLEJdzBmd8nsrZdf5jIATelBOYIMHeY6uuIAEmx",
      "email_domain_set_id": 1,
      "email_domain_set_name": "Example",
      "email_domains": [
        {
          "id": 1,
          "domain": "example.com",
          "email_domain_set_id": 1,
          "canvas_root_account_uuid": "35WLEJdzBmd8nsrZdf5jIATelBOYIMHeY6uuIAEmx",
          "created_at": "2025/03/28 13:11:23 +0000",
          "updated_at": "2025/03/28 13:11:23 +0000",
          "deleted_at": null
        }
      ],
      "status": "inactive"
    }
  ]
}

get

Authorizations

Path parameters

idintegerRequired

Responses

get

HTTPcURLJavaScriptPython

GET /api/v1/email_domain_sets/{id} HTTP/1.1
Host: replace_me
Authorization: YOUR_API_KEY
Accept: */*

200

Getting a specific email domain set

{
  "id": 3,
  "name": "Example",
  "account_id": 31,
  "canvas_root_account_uuid": "39WLEJdzBmd8nsrZdf5jIATelBOYIMHeY6uuIAEmx",
  "created_at": "2025/03/28 13:11:23 +0000",
  "updated_at": "2025/03/28 13:11:23 +0000",
  "deleted_at": null
}

put

Authorizations

Path parameters

idintegerRequired

Body

Responses

put

HTTPcURLJavaScriptPython

PUT /api/v1/email_domain_sets/{id} HTTP/1.1
Host: replace_me
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 70

{
  "email_domain_set": {
    "name": "text",
    "email_domains_attributes": "text"
  }
}

200

Updating an email domain set

{
  "email_domain_set": {
    "id": 2,
    "name": "API Name",
    "account_id": 29,
    "email_domains": [
      {
        "id": 3,
        "domain": "example1.com",
        "email_domain_set_id": 2,
        "canvas_root_account_uuid": "37WLEJdzBmd8nsrZdf5jIATelBOYIMHeY6uuIAEmx",
        "created_at": "2025/03/28 13:11:23 +0000",
        "updated_at": "2025/03/28 13:11:23 +0000",
        "deleted_at": null
      },
      {
        "id": 4,
        "domain": "example2.org",
        "email_domain_set_id": 2,
        "canvas_root_account_uuid": "37WLEJdzBmd8nsrZdf5jIATelBOYIMHeY6uuIAEmx",
        "created_at": "2025/03/28 13:11:23 +0000",
        "updated_at": "2025/03/28 13:11:23 +0000",
        "deleted_at": null
      },
      {
        "id": 2,
        "domain": "example.com",
        "email_domain_set_id": 2,
        "canvas_root_account_uuid": "37WLEJdzBmd8nsrZdf5jIATelBOYIMHeY6uuIAEmx",
        "created_at": "2025/03/28 13:11:23 +0000",
        "updated_at": "2025/03/28 13:11:23 +0000",
        "deleted_at": null
      }
    ]
  }
}

get

Authorizations

Query parameters

searchstringOptional

A value to filter the Email Domain Sets by name

exactstringOptional

A boolean to set whether the search should only include results that match exactly

Responses

Responseobject

get

HTTPcURLJavaScriptPython

GET /api/v1/email_domain_sets HTTP/1.1
Host: replace_me
Authorization: YOUR_API_KEY
Accept: */*

200

Listing email domain sets

{
  "email_domain_sets": [
    {
      "id": 4,
      "name": "Example",
      "account_id": 33,
      "email_domains": [
        {
          "id": 6,
          "domain": "example.com",
          "email_domain_set_id": 4,
          "canvas_root_account_uuid": "41WLEJdzBmd8nsrZdf5jIATelBOYIMHeY6uuIAEmx",
          "created_at": "2025/03/28 13:11:23 +0000",
          "updated_at": "2025/03/28 13:11:23 +0000",
          "deleted_at": null
        }
      ]
    }
  ],
  "meta": {
    "total_pages": 0
  }
}