Create a check profile

POST

/api/v1/data-source-groups

curl --request POST \
  --url https://app.hostrepute.com/api/v1/data-source-groups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "Marketing IPs", "slug": "marketing-ips", "description": "Sending IPs for newsletters", "is_default": false, "deliverability_checks_enabled": true, "deliverability_checks": [ "spf_record", "dmarc_record" ] }'

Create a check profile for your team. A profile created through the API has no blocklists yet; choose them in the portal. Your plan limits how many profiles can run email authentication checks.

Needs the data-source-group:create ability.

Authorizations

• bearer

Request Body^required

Media typeapplication/json

object

name

required

The name of the check profile, up to 255 characters.

string

Example

Marketing IPs

slug

A URL-friendly name, up to 255 characters. Made from the name when you leave it out.

string

nullable

Example

marketing-ips

description

A short description, up to 255 characters.

string

nullable

Example

Sending IPs for newsletters

is_default

Make this the team’s default profile. The previous default stops being the default. Defaults to false.

boolean

Example

false

deliverability_checks_enabled

Run email authentication checks for the domains and IPs that use this profile. Defaults to false.

boolean

Example

true

deliverability_checks

The email authentication checks to run, from reverse_dns, forward_confirmed_reverse_dns, generic_ptr, ptr_hostname_format, mx_health, spf_record, spf_strict, spf_lookup_limit, dmarc_record, dmarc_strict, mta_sts, tls_rpt and bimi. Read https://docs.hostrepute.com/reference/email-authentication-checks/ for what each one verifies.

Array<string>

Example

[
  "spf_record",
  "dmarc_record"
]

Responses

201

Media typeapplication/json

object

data

object

uuid

string

name

string

slug

string

description

string

is_default

boolean

deliverability_checks_enabled

boolean

deliverability_checks

Array<string>

created_at

string

updated_at

string

Example

{
  "data": {
    "uuid": "01a178db-d7b1-7394-ae88-b7a0aac5eaa4",
    "name": "Marketing IPs",
    "slug": "marketing-ips",
    "description": "Sending IPs for newsletters",
    "is_default": false,
    "deliverability_checks_enabled": true,
    "deliverability_checks": [
      "spf_record",
      "dmarc_record"
    ],
    "created_at": "2026-10-26T15:37:15.000000Z",
    "updated_at": "2026-10-26T15:37:15.000000Z"
  }
}

422

Plan limit reached

Media typeapplication/json

object

message

string

errors

object

deliverability_checks_enabled

Array<string>

Example

{
  "message": "Your current plan includes 5 deliverability profile(s).",
  "errors": {
    "deliverability_checks_enabled": [
      "Your current plan includes 5 deliverability profile(s)."
    ]
  }
}