experiments

Embed

<a href="https://hermeticor.com/docs/ref-experiments"><img src="https://hermeticor.com/docs/_api/public/orgs/5fcd8b3c-a27c-4688-972f-de710125592f/spaces/caf5dc05-15f7-4e0c-bdb8-ab29ede6211e/pages/0822d341-d2db-4817-b8a1-8090095c2267/social-card.svg?v=3e7ae33eec8b" alt="experiments" width="600" height="315"></a>

PUThttps://hermeticor.com/v1/frequency-settings

Request body

application/json

scopeTypestring

workspace | campaign | workflow = workspace

scopeIdstring

capsobject[]

= []

Show child parameters

channelstringrequired

email | sms | whatsapp | push | postcard

purposestringrequired

marketing | prospecting | transactional | operational

maxintegerrequired

windowHoursintegerrequired

smartSendingobject

Show child parameters

hoursintegerrequired

actionstring

defer | skip = skip

{
  "scopeType": "workspace",
  "scopeId": "string",
  "caps": [],
  "smartSending": {
    "hours": 0,
    "action": "skip"
  }
}

Code samples

cURL

curl -X PUT "https://hermeticor.com/v1/frequency-settings" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scopeType":"workspace","scopeId":"string","caps":[],"smartSending":{"hours":0,"action":"skip"}}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "id": "string"
}

Schema

idstringrequired

4XX Default Response

Example

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}

Schema

errorobjectrequired

Show child parameters

codestringrequired

messagestringrequired

detailsobject

5XX Default Response

Same as 4XX · PUT /v1/frequency-settings

DELETEhttps://hermeticor.com/v1/frequency-settings/{id}

Parameters

idstringpathrequired

Code samples

cURL

curl -X DELETE "https://hermeticor.com/v1/frequency-settings/{id}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "ok": true
}

Schema

okbooleanrequired

true

4XX Default Response

Same as 4XX · PUT /v1/frequency-settings

5XX Default Response

Same as 4XX · PUT /v1/frequency-settings

POSThttps://hermeticor.com/v1/campaigns/{id}/resend

Parameters

idstringpathrequired

Request body

application/json

tostringrequired

non_openers | non_clickers | new_subscribers | non_purchasers

subjectstringrequired

atstring

{
  "to": "non_openers",
  "subject": "string",
  "at": "2024-01-01T00:00:00Z"
}

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/campaigns/{id}/resend" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"non_openers","subject":"string","at":"2024-01-01T00:00:00Z"}'

TypeScript

Python

PHP

Ruby

Java

Responses

201 Default Response

Example

{
  "id": "string",
  "name": "string",
  "channel": "email",
  "purpose": "marketing",
  "status": "draft",
  "audience": {
    "includeSegmentIds": [],
    "includeListIds": [],
    "excludeSegmentIds": [],
    "excludeListIds": [],
    "onePerCompany": true,
    "everyone": true,
    "includeTags": [
      "string"
    ],
    "excludeTags": [
      "string"
    ]
  },
  "audienceFrozenAt": "2024-01-01T00:00:00Z",
  "templateId": "string",
  "topicId": "string",
  "route": {
    "connectionId": "string",
    "poolId": "string",
    "routePolicyId": "string"
  },
  "schedule": {
    "at": "2024-01-01T00:00:00Z",
    "tz": "UTC",
    "recipientLocal": false,
    "throttlePerHour": 0,
    "window": {
      "startMin": 0,
      "endMin": 0
    },
    "sendTime": "fixed",
    "pastZones": "immediately",
    "batchSize": 0
  },
  "abTest": {
    "testPercent": 20,
    "metric": "clicks",
    "waitHours": 4,
    "auto": true,
    "method": "bayesian_beta"
  },
  "variants": [
    {
      "key": "string",
      "templateVersionId": "string",
      "subject": "string",
      "fromName": "string",
      "previewText": "string",
      "replyTo": "string",
      "imageAssetId": "string",
      "sendOffset": 0,
      "weight": 1
    }
  ],
  "utm": {},
  "tracking": {
    "opens": true,
    "clicks": true
  },
  "autoPause": {
    "enabled": true,
    "maxFailureRate": 0.25,
    "maxBounceRate": 0.1,
    "minSample": 50
  },
  "slug": "string",
  "archiveProfile": {},
  "inArchive": true,
  "ownerId": "string",
  "startsOn": "string",
  "endsOn": "string",
  "notes": "string",
  "approvalStatus": "string",
  "approvedBy": "string",
  "approvalSubmittedBy": "string",
  "approvalComment": "string",
  "startedAt": "2024-01-01T00:00:00Z",
  "completedAt": "2024-01-01T00:00:00Z",
  "testSentAt": "2024-01-01T00:00:00Z",
  "contentErasedAt": "2024-01-01T00:00:00Z",
  "stats": {},
  "archivedAt": "2024-01-01T00:00:00Z",
  "parentCampaignId": "string",
  "reviewDrafts": true,
  "reviewDeadline": {
    "hours": 0,
    "action": "send"
  },
  "failureReason": "string",
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-01T00:00:00Z"
}

Schema

idstringrequired

namestringrequired

channelstringrequired

email | sms | whatsapp | push | postcard

purposestringrequired

marketing | prospecting | transactional | operational

statusstringrequired

audienceobjectrequired

Show child parameters

includeSegmentIdsstring[]required

= []

includeListIdsstring[]required

= []

excludeSegmentIdsstring[]required

= []

excludeListIdsstring[]required

= []

onePerCompanyboolean

everyoneboolean

includeTagsstring[]

excludeTagsstring[]

audienceFrozenAtstringrequired

templateIdstringrequired

topicIdstringrequired

routeobjectrequired

Show child parameters

connectionIdstring

poolIdstring

routePolicyIdstring

scheduleobjectrequired

Show child parameters

atstringrequired

tzstringrequired

= UTC

recipientLocalbooleanrequired

= false

throttlePerHourinteger

windowobject

Show child parameters

startMinintegerrequired

endMinintegerrequired

sendTimestringrequired

fixed | optimized = fixed

pastZonesstring

immediately | tomorrow

batchSizeinteger

abTestobjectrequired

Show child parameters

testPercentintegerrequired

= 20

metricstringrequired

clicks | replies | conversions | revenue | opens = clicks

waitHoursintegerrequired

= 4

autobooleanrequired

= true

methodstringrequired

bayesian_beta | frequentist_ztest = bayesian_beta

variantsVariantsItem[]

Show child parameters

keystringrequired

templateVersionIdstringrequired

subjectstring

fromNamestring

previewTextstring

replyTostring

imageAssetIdstring

sendOffsetintegerrequired

= 0

weightintegerrequired

= 1

utmobjectrequired

trackingobjectrequired

Show child parameters

opensboolean

clicksboolean

autoPauseobjectrequired

Show child parameters

enabledbooleanrequired

= true

maxFailureRatenumberrequired

= 0.25

maxBounceRatenumberrequired

= 0.1

minSampleintegerrequired

= 50

slugstringrequired

archiveProfileobjectrequired

inArchivebooleanrequired

ownerIdstring

startsOnstring

endsOnstring

notesstring

approvalStatusstringrequired

approvedBystringrequired

approvalSubmittedBystring

approvalCommentstring

startedAtstringrequired

completedAtstringrequired

testSentAtstringrequired

contentErasedAtstring

statsobjectrequired

archivedAtstring

parentCampaignIdstring

reviewDraftsboolean

reviewDeadlineobject

Show child parameters

hoursintegerrequired

actionstringrequired

send | skip

failureReasonstring

createdAtstringrequired

updatedAtstringrequired

4XX Default Response

Same as 4XX · PUT /v1/frequency-settings

5XX Default Response

Same as 4XX · PUT /v1/frequency-settings

GEThttps://hermeticor.com/v1/campaigns/{id}/ab-report

Parameters

idstringpathrequired

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/campaigns/{id}/ab-report" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "arms": [
    {
      "key": "string",
      "n": 0,
      "conversions": 0,
      "rate": 0,
      "ci": [
        0
      ],
      "pBest": 0,
      "expectedLoss": 0,
      "pValue": 0,
      "guardrails": [
        {
          "metric": "unsubscribe",
          "rate": 0,
          "pWorse": 0,
          "failed": true
        }
      ],
      "orders": 0,
      "revenueMinor": 0
    }
  ],
  "recommendation": {
    "kind": "winner",
    "key": "string"
  },
  "reason": "string",
  "method": "bayesian_beta",
  "metric": "clicks",
  "significant": true,
  "sampleSufficient": true,
  "caveat": "string"
}

Schema

armsArmsItem[]required

Show child parameters

keystringrequired

nintegerrequired

conversionsintegerrequired

ratenumberrequired

cinumber[]required

pBestnumberrequired

expectedLossnumberrequired

pValuenumberrequired

guardrailsGuardrailsItem2[]required

Show child parameters

metricstringrequired

unsubscribe | complaint | bounce

ratenumberrequired

pWorsenumberrequired

failedbooleanrequired

ordersinteger

revenueMinornumber

recommendationobjectrequired

Show child parameters

kindstringrequired

winner | keep_running | no_winner

keystringrequired

reasonstringrequired

methodstringrequired

bayesian_beta | frequentist_ztest

metricstringrequired

clicks | replies | conversions | revenue | opens

significantbooleanrequired

sampleSufficientbooleanrequired

caveatstringrequired

4XX Default Response

Same as 4XX · PUT /v1/frequency-settings

5XX Default Response

Same as 4XX · PUT /v1/frequency-settings

POSThttps://hermeticor.com/v1/campaigns/{id}/ab-rollout

Parameters

idstringpathrequired

Request body

application/json

winnerKeystring

{
  "winnerKey": "string"
}

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/campaigns/{id}/ab-rollout" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"winnerKey":"string"}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "rolledOut": true,
  "winnerKey": "string",
  "recipients": 0,
  "reason": "string"
}

Schema

rolledOutbooleanrequired

winnerKeystringrequired

recipientsintegerrequired

reasonstringrequired

4XX Default Response

Same as 4XX · PUT /v1/frequency-settings

5XX Default Response

Same as 4XX · PUT /v1/frequency-settings

Next part

Updated Nov 8, 2026

Was this page helpful?