outbound

Embed
Preview of the card
<a href="https://hermeticor.com/docs/ref-outbound"><img src="https://hermeticor.com/docs/_api/public/orgs/5fcd8b3c-a27c-4688-972f-de710125592f/spaces/caf5dc05-15f7-4e0c-bdb8-ab29ede6211e/pages/3a54f1ef-9d8b-4cc5-aeee-3401241a9434/social-card.svg?v=3e7ae33eec8b" alt="outbound" width="600" height="315"></a>
DELETEhttps://hermeticor.com/v1/outbound/schedules/{id}

Parameters

idstringpathrequired

Code samples

cURL
curl -X DELETE "https://hermeticor.com/v1/outbound/schedules/{id}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"
TypeScript
Python
Go
PHP
Ruby
Java

Responses

200 Default Response
Example
{
  "ok": true
}
Schema
okbooleanrequired
true
4XX Default Response
Example
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}
Schema
errorobjectrequired
Show child parameters
codestringrequired
messagestringrequired
detailsobject
5XX Default Response

Same as 4XX · DELETE /v1/outbound/schedules/{id}

GEThttps://hermeticor.com/v1/outbound/analytics/v2

Opens, clicks, replies, time-to-reply by day, step, variant, provider, category, status or owner (group=status: `prospects` holds the number of prospects in each state)

Parameters

sequenceIdstringquery
fromstringquery
tostringquery
sequenceIdsstring[]query
groupstringquery
summary | day | step | variant | provider | category | status | user | sent_hour | sent_weekday | sequence = summary

Code samples

cURL
curl -X GET "https://hermeticor.com/v1/outbound/analytics/v2" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"
TypeScript
Python
Go
PHP
Ruby
Java

Responses

200 Default Response
Example
{
  "group": "string",
  "items": [
    {
      "key": "string",
      "sent": 0,
      "bounced": 0,
      "opens": 0,
      "uniqueOpens": 0,
      "clicks": 0,
      "uniqueClicks": 0,
      "replies": 0,
      "positive": 0,
      "negative": 0,
      "openRate": 0,
      "clickRate": 0,
      "replyRate": 0,
      "bounceRate": 0,
      "positiveRate": 0,
      "avgTimeToReplySec": 0,
      "prospects": 0
    }
  ]
}
Schema
groupstringrequired
itemsobject[]required
Show child parameters
keystringrequired
sentintegerrequired
bouncedintegerrequired
opensintegerrequired
uniqueOpensintegerrequired
clicksintegerrequired
uniqueClicksintegerrequired
repliesintegerrequired
positiveintegerrequired
negativeintegerrequired
openRatenumberrequired
clickRatenumberrequired
replyRatenumberrequired
bounceRatenumberrequired
positiveRatenumberrequired
avgTimeToReplySecnumberrequired
prospectsinteger
4XX Default Response

Same as 4XX · DELETE /v1/outbound/schedules/{id}

5XX Default Response

Same as 4XX · DELETE /v1/outbound/schedules/{id}

GEThttps://hermeticor.com/v1/outbound/sequences/count

Code samples

cURL
curl -X GET "https://hermeticor.com/v1/outbound/sequences/count" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"
TypeScript
Python
Go
PHP
Ruby
Java

Responses

200 Default Response
Example
{
  "total": 0,
  "byStatus": {}
}
Schema
totalintegerrequired
byStatusobjectrequired
4XX Default Response

Same as 4XX · DELETE /v1/outbound/schedules/{id}

5XX Default Response

Same as 4XX · DELETE /v1/outbound/schedules/{id}

GEThttps://hermeticor.com/v1/outbound/sequences/search

Sequences a contact is in, by email

Parameters

emailstringqueryrequired
limitintegerquery
Page size; omitted returns the whole list
cursorstringquery
Opaque: the nextCursor of the previous page

Code samples

cURL
curl -X GET "https://hermeticor.com/v1/outbound/sequences/search?email=<email>" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"
TypeScript
Python
Go
PHP
Ruby
Java

Responses

200 Default Response
Example
{
  "items": [
    {
      "sequenceId": "string",
      "name": "string",
      "enrollmentId": "string",
      "state": "string",
      "enteredAt": "2024-01-01T00:00:00Z"
    }
  ],
  "nextCursor": "string"
}
Schema
itemsobject[]required
Show child parameters
sequenceIdstringrequired
namestringrequired
enrollmentIdstringrequired
statestringrequired
enteredAtstringrequired
nextCursorstringrequired
4XX Default Response

Same as 4XX · DELETE /v1/outbound/schedules/{id}

5XX Default Response

Same as 4XX · DELETE /v1/outbound/schedules/{id}

POSThttps://hermeticor.com/v1/outbound/sequences/import

Request body

application/json
namestring
dataobjectrequired
Show child parameters
versionnumberrequired
1
namestringrequired
settingsobjectrequired
Show child parameters
stepsStepsItem[]
= []
scheduleobject
= {"weekdays":[1,2,3,4,5],"startMin":540,"endMin":1020,"timezoneSource":"prospect","timezone":"UTC"}
mailboxobject
= {"sticky":true,"onUnavailable":"pause"}
dailyNewLimitinteger
followUpPercentinteger
plainTextOnlyboolean
trackOpensboolean
unsubscribeTextstring
spintaxModestring
random | sequential
variablesobject
blocklistobject
reviewBeforeSendboolean
reviewEachMessageboolean
stopobject
= {"onReply":"human","onAutoReply":"continue","onOoo":"pause_until_return","onCompanyReply":"none"}
onCategoryOnCategoryItem[]
ownerUserIdstring
scheduleIdstring
dedupeobject
= {"crossSequence":"skip","contactedWithinDays":0,"domain":false}
startAtstring
minGapMinutesinteger
senderOverridesobject
abmobject
{
  "name": "string",
  "data": {
    "version": 1,
    "name": "string",
    "settings": {
      "steps": [],
      "schedule": {
        "weekdays": [
          1,
          2,
          3,
          4,
          5
        ],
        "startMin": 540,
        "endMin": 1020,
        "timezoneSource": "prospect",
        "timezone": "UTC"
      },
      "mailbox": {
        "sticky": true,
        "onUnavailable": "pause"
      },
      "dailyNewLimit": 0,
      "followUpPercent": 0,
      "plainTextOnly": true,
      "trackOpens": true,
      "unsubscribeText": "string",
      "spintaxMode": "random",
      "variables": {},
      "blocklist": {
        "emails": [
          "string"
        ],
        "domains": []
      },
      "reviewBeforeSend": true,
      "reviewEachMessage": true,
      "stop": {
        "onReply": "human",
        "onAutoReply": "continue",
        "onOoo": "pause_until_return",
        "onCompanyReply": "none"
      },
      "onCategory": [
        {
          "category": "positive",
          "sequenceId": "string",
          "stopCurrent": true
        }
      ],
      "ownerUserId": "string",
      "scheduleId": "string",
      "dedupe": {
        "crossSequence": "skip",
        "contactedWithinDays": 0,
        "domain": false
      },
      "startAt": "2024-01-01T00:00:00Z",
      "minGapMinutes": 0,
      "senderOverrides": {},
      "abm": {
        "maxPerAccount": 5,
        "onAccountReply": "stop"
      }
    }
  }
}

Code samples

cURL
curl -X POST "https://hermeticor.com/v1/outbound/sequences/import" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","data":{"version":1,"name":"string","settings":{"steps":[],"schedule":{"weekdays":[1,2,3,4,5],"startMin":540,"endMin":1020,"timezoneSource":"prospect","timezone":"UTC"},"mailbox":{"sticky":true,"onUnavailable":"pause"},"dailyNewLimit":0,"followUpPercent":0,"plainTextOnly":true,"trackOpens":true,"unsubscribeText":"string","spintaxMode":"random","variables":{},"blocklist":{"emails":["string"],"domains":[]},"reviewBeforeSend":true,"reviewEachMessage":true,"stop":{"onReply":"human","onAutoReply":"continue","onOoo":"pause_until_return","onCompanyReply":"none"},"onCategory":[{"category":"positive","sequenceId":"string","stopCurrent":true}],"ownerUserId":"string","scheduleId":"string","dedupe":{"crossSequence":"skip","contactedWithinDays":0,"domain":false},"startAt":"2024-01-01T00:00:00Z","minGapMinutes":0,"senderOverrides":{},"abm":{"maxPerAccount":5,"onAccountReply":"stop"}}}}'
TypeScript
Python
Go
PHP
Ruby
Java

Responses

201 Default Response
Example
{
  "id": "string",
  "name": "string",
  "purpose": "marketing",
  "mode": "sequence",
  "status": "draft",
  "publishedVersionId": "string",
  "folder": "string",
  "tags": [
    "string"
  ],
  "sequence": {
    "steps": [],
    "schedule": {
      "weekdays": [
        1,
        2,
        3,
        4,
        5
      ],
      "startMin": 540,
      "endMin": 1020,
      "timezoneSource": "prospect",
      "timezone": "UTC"
    },
    "mailbox": {
      "sticky": true,
      "onUnavailable": "pause"
    },
    "dailyNewLimit": 0,
    "followUpPercent": 0,
    "plainTextOnly": true,
    "trackOpens": true,
    "unsubscribeText": "string",
    "spintaxMode": "random",
    "variables": {},
    "blocklist": {
      "emails": [],
      "domains": []
    },
    "reviewBeforeSend": true,
    "reviewEachMessage": true,
    "stop": {
      "onReply": "human",
      "onAutoReply": "continue",
      "onOoo": "pause_until_return",
      "onCompanyReply": "none"
    },
    "onCategory": [
      {
        "category": "positive",
        "sequenceId": "string",
        "stopCurrent": true
      }
    ],
    "ownerUserId": "string",
    "scheduleId": "string",
    "dedupe": {
      "crossSequence": "skip",
      "contactedWithinDays": 0,
      "domain": false
    },
    "startAt": "2024-01-01T00:00:00Z",
    "minGapMinutes": 0,
    "senderOverrides": {},
    "abm": {
      "maxPerAccount": 5,
      "onAccountReply": "stop"
    }
  },
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-01T00:00:00Z"
}
Schema
idstringrequired
namestringrequired
purposestringrequired
marketing | prospecting | transactional | operational
modestringrequired
sequence
statusstringrequired
draft | live | paused | archived
publishedVersionIdstringrequired
folderstringrequired
tagsstring[]required
sequenceobjectrequired
Show child parameters
stepsStepsItem3[]required
= []
scheduleobjectrequired
= {"weekdays":[1,2,3,4,5],"startMin":540,"endMin":1020,"timezoneSource":"prospect","timezone":"UTC"}
Show child parameters
weekdaysinteger[]required
= [1,2,3,4,5]
startMinintegerrequired
= 540
endMinintegerrequired
= 1020
timezoneSourcestringrequired
prospect | sequence = prospect
timezonestringrequired
= UTC
mailboxobjectrequired
= {"sticky":true,"onUnavailable":"pause"}
Show child parameters
poolIdstring
connectionIdstring
stickybooleanrequired
= true
onUnavailablestringrequired
pause | reassign = pause
dailyNewLimitinteger
followUpPercentinteger
plainTextOnlyboolean
trackOpensboolean
unsubscribeTextstring
spintaxModestring
random | sequential
variablesobject
blocklistobject
Show child parameters
emailsobject[]required
= []
domainsstring[]required
= []
reviewBeforeSendboolean
reviewEachMessageboolean
stopobjectrequired
= {"onReply":"human","onAutoReply":"continue","onOoo":"pause_until_return","onCompanyReply":"none"}
Show child parameters
onReplystringrequired
human | any = human
onAutoReplystringrequired
continue | pause = continue
onOoostringrequired
pause_until_return | continue | stop = pause_until_return
onCompanyReplystringrequired
none | stop | pause = none
onCategoryOnCategoryItem2[]
Show child parameters
categorystringrequired
positive | negative | neutral | ooo | auto_reply | bounce | unsubscribe | meeting | wrong_person
sequenceIdstringrequired
stopCurrentbooleanrequired
= true
ownerUserIdstring
scheduleIdstring
dedupeobjectrequired
= {"crossSequence":"skip","contactedWithinDays":0,"domain":false}
Show child parameters
crossSequencestringrequired
skip | allow = skip
contactedWithinDaysintegerrequired
= 0
domainbooleanrequired
= false
startAtstring
minGapMinutesinteger
senderOverridesobject
abmobject
Show child parameters
maxPerAccountintegerrequired
= 5
onAccountReplystringrequired
none | stop | pause = stop
createdAtstringrequired
updatedAtstringrequired
4XX Default Response

Same as 4XX · DELETE /v1/outbound/schedules/{id}

5XX Default Response

Same as 4XX · DELETE /v1/outbound/schedules/{id}

Updated