Error Response Format

All API errors follow RFC 9457 Problem Details:
{
  "title": "Not Found",
  "status": 404,
  "detail": "Sequence with ID 42 was not found",
  "errorCode": 1
}
FieldTypeDescription
titlestringError category (e.g., “Not Found”, “Bad Request”, “Conflict”)
statusintegerHTTP status code
detailstringHuman-readable explanation of the specific error
errorCodeintegerDomain-specific error code for programmatic handling

HTTP Status Codes

StatusTitleWhen
400Bad RequestInvalid input, pagination, or filter parameters
401UnauthorizedMissing or invalid API key
403ForbiddenInsufficient permissions for the resource
404Not FoundResource does not exist
409ConflictState conflict, duplicate name, or archived resource
429Too Many RequestsRate limit exceeded

Domain Error Codes

Error codes are scoped per domain. The same numeric code may have different meanings across domains.

Sequences

errorCodeNameHTTPDescription
1NotFound404Sequence not found
2Forbidden403Access forbidden
3SchedulerNotFound404Associated scheduler not found
4EmailAccountNotFound404Associated email account not found
5LinkedInAccountNotFound404Associated LinkedIn account not found
6SequenceArchived409Sequence is archived
7InvalidStep400Invalid step configuration
8EmptySubject400Email template subject is empty
9EmailTemplateNotFound404Email template not found
10InvalidPagination400Invalid pagination parameters

Sequence Actions

errorCodeNameHTTPDescription
0Unknown400Unknown error
1NotFound404Sequence not found
2Forbidden403Access forbidden
3Archived409Sequence is already archived
4New409Sequence is in New status
5Active409Sequence is already active
6NoContacts400Sequence has no contacts
7NoEmailAccounts400Sequence has no email accounts
8SalesAgentNotAllowed403Sales agent is not allowed
9Status409Invalid status transition
10OwnerLimitExceeded400Owner sequence limit exceeded
11TeamMemberNotFound400Team member not found

Sequence Steps

errorCodeNameHTTPDescription
1InvalidInput400Invalid input data
2InvalidStep400Invalid step configuration
3InternalError400Internal processing error
4NotFound404Step not found
5StepLocked400Step is locked and cannot be modified
6UnsupportedOperation400Operation not supported for this step type
7StepLockedHasChildren400Step is locked because it has child steps
8StepLockedSubjectSource400Step is locked as subject source
9StepLockedSubjectSourceWithChildren400Step is locked as subject source with children

Sequence Contacts

errorCodeNameHTTPDescription
1InvalidInput400Invalid input data
2SequenceNotFound404Sequence not found
3NoStepsInSequence400Sequence has no steps
4InternalError400Internal error
5ContactLimitExceeded400Contact limit for sequence exceeded
6ContactAlreadyInSequence409Contact already in sequence
7ContactNotFound404Contact not found
8NotInSequence404Contact not in sequence
9InvalidStatusTransition409Invalid status transition
10SequenceArchived409Sequence is archived
11Forbidden403Access forbidden

Sequence Templates

errorCodeNameHTTPDescription
1NotFound404Template not found
2DuplicateName409Template name already exists
3Forbidden403Access forbidden
4SequenceNotFound404Associated sequence not found
5InvalidScope400Invalid template scope
6OrgTemplatesDisabled403Organization-wide templates are disabled

Sequence Folders

errorCodeNameHTTPDescription
1NotFound404Folder not found
2DuplicateName409Folder name already exists
3Forbidden403Access forbidden
4InvalidPagination400Invalid pagination parameters
5InvalidSort400Invalid sort parameter

Sequence Email Accounts

errorCodeNameHTTPDescription
1NotFound404Email account not found
2Forbidden403Access forbidden
3LimitReached409Limit reached
4Common400General error

Contacts

errorCodeNameHTTPDescription
1NotFound404Contact not found
2InvalidInput400Invalid input
3Forbidden403Access forbidden
4Duplicate400Contact already exists
5InvalidPagination400Invalid pagination
6LimitExceeded400Contact limit exceeded
7EmailAccountNotFound400Email account not found
8ContactInBlackList400Contact is in blacklist
9EmailSendingFailed400Email sending failed
10SequenceNotFound400Sequence not found

Accounts

errorCodeNameHTTPDescription
1NotFound404Account not found
2Forbidden403Access forbidden
3InvalidInput400Invalid input
4InvalidPagination400Invalid pagination parameters

Contact Lists

errorCodeNameHTTPDescription
1NotFound404List not found
2Forbidden403Access forbidden
3DuplicateName409List name already exists
4NameTooShort400Name too short
5NameIsEmpty400Name is empty
6AccessChangeRejected400Access change rejected
7InvalidPagination400Invalid pagination parameters
8ContactNotProcessed400Contact not processed

Contact Blacklist Rules

errorCodeNameHTTPDescription
1NotFound404Rule not found
2Duplicate409Rule already exists
3GlobalRuleReadOnly403Global rule cannot be modified
4InvalidPattern400Invalid blacklist pattern
5NotAdded400Rule was not added
6InvalidPagination400Invalid pagination parameters

Custom Fields

errorCodeNameHTTPDescription
1NotFound404Field not found
2InvalidInput400Invalid input
3Forbidden403Access forbidden
4DuplicateName409Field name already exists
5LimitExceeded400Custom field limit exceeded
6HasValues400Field has existing values and cannot be deleted

Email Accounts

errorCodeNameHTTPDescription
1InvalidInput400Invalid input
2LimitReached409Account limit reached
3InternalError400Internal error
4NotFound404Email account not found
5Forbidden403Access forbidden
6ConnectionFailed400Connection test failed
7InvalidPagination400Invalid pagination parameters

Email Templates

errorCodeNameHTTPDescription
1NotFound404Template not found
2DuplicateName409Template name already exists
3Forbidden403Access forbidden
4InvalidPagination400Invalid pagination parameters
5InvalidFilter400Invalid filter parameters
6FolderNotFound404Template folder not found
7AttachmentNotFound404Attachment not found
8EmailAccountNotFound404Email account not found
9ContactNotFound404Contact not found
10RenderFailed400Template rendering failed
11SendTestFailed400Test email sending failed
12TooManyAttachments400Too many attachments

Email Template Folders

errorCodeNameHTTPDescription
1NotFound404Folder not found
2DuplicateName409Folder name already exists
3Forbidden403Access forbidden
4AlreadyShared409Folder is already shared
5IsDefault400Cannot modify default folder

Holiday Calendars

errorCodeNameHTTPDescription
1NotFound404Calendar not found
2Forbidden403Access forbidden
3DuplicateName409Calendar name already exists
4NotCustomCalendar400Only custom calendars can be modified

LinkedIn Accounts

errorCodeNameHTTPDescription
1InvalidInput400Invalid input
2NotFound404LinkedIn account not found
3AccountInUse409Account is in use
4CookieInvalid400LinkedIn cookie is invalid
5LimitReached400Account limit reached
6PaymentFailed400Payment verification failed
7InternalError400Internal error
8VoiceProfileConflict400Voice profile conflict

Schedulers

errorCodeNameHTTPDescription
1NotFound404Scheduler not found
2DeleteRejected403Cannot delete scheduler
3DuplicateName409Scheduler name already exists
4InvalidTimezone400Invalid timezone identifier
5HolidayCalendarNotFound404Holiday calendar not found
6Forbidden403Access forbidden
7LinkNotFound400Calendar link not found
8AlreadyLinked409Calendar already linked

Tasks

errorCodeNameHTTPDescription
1NotFound404Task not found
2InvalidInput400Invalid input
3CanOnlyEditNewTasks400Can only edit tasks in New status
4CannotChangeSequenceTaskType400Cannot change type of sequence task
5CannotChangeSequenceTaskContact400Cannot change contact of sequence task
6InvalidDates400Invalid date values
7CannotComplete409Cannot complete in current state
8CannotDelete409Cannot delete in current state
9RenderError409Template rendering error
10TooManyAttachments400Too many attachments
11ContactNotAccessible400Contact is not accessible
12Forbidden403Access forbidden
13InvalidPagination400Invalid pagination parameters
14TooManyTasksToDelete400Too many tasks in single delete request