Batch

A group of records (Prospect, Account, etc.) in which the same particular action was performed.

action
string or null <= 255 characters

Action performed on the batch.

canceledAt
string or null <date-time>

The date and time the batch was canceled.

confirmCount
integer or null

The number of items in the batch to be confirmed.

confirmedAt
string or null <date-time>

The date and time the batch was confirmed.

confirmedCountRequired
boolean or null

Require the user to explicitly confirm the confirm_count.

createdAt
string or null <date-time>

The date and time the batch was created.

externalStartPayload
string or null <= 16777215 characters

Optional parameter used to handle external batch operations

failures
integer or null

The number of failed batch items associated with this batch.

finishedAt
string or null <date-time>

The date and time the batch was finished.

payload
object or null

The input payload for the batch operation.

pending
integer or null

The number of pending batch items associated with this batch.

startedAt
string or null <date-time>

The date and time the batch was started.

state
string or null <= 255 characters

The current state of the batch.

summary
object or null

The summary of the batch including failure information.

total
integer or null

The total number of batch items associated with this batch.

updatedAt
string or null <date-time>

The date and time the batch was last updated.

{
  • "action": "string",
  • "canceledAt": "2019-08-24T14:15:22Z",
  • "confirmCount": 0,
  • "confirmedAt": "2019-08-24T14:15:22Z",
  • "confirmedCountRequired": true,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "externalStartPayload": "string",
  • "failures": 0,
  • "finishedAt": "2019-08-24T14:15:22Z",
  • "payload": { },
  • "pending": 0,
  • "startedAt": "2019-08-24T14:15:22Z",
  • "state": "string",
  • "summary": { },
  • "total": 0,
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Batch Relationships

object

The batch items associated with this batch.

object
{}

Batch Resource Metadata

METADATA NAME DESCRIPTION QUERY PARAM
canWrite A boolean value indicating whether the current API user has write access to this resource. provideAuthorizationMeta

⌵ Batch Actions

Get a Collection of Batches

SecuritybearerAuth
Responses
200

OK

422

JSON error message

get/batches
Request samples 
Response samples 
application/vnd.api+json
{
  • "data": [
    ]
}
Create a New Batch
SecuritybearerAuth 
Request 
Request Body schema: application/vnd.api+json
required
object
 
Responses 
201
Created


422
JSON error message


post/batches
Request samples 
application/vnd.api+json
{
  • "data": {
    }
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Get a Batch by ID
SecuritybearerAuth 
Request 
path Parameters
id
required
integer
 
Responses 
200
OK


404
Not Found


get/batches/{id}
Request samples 
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Update a Batch
SecuritybearerAuth 
Request 
path Parameters
id
required
integer
 
Request Body schema: application/vnd.api+json
required
object
 
Responses 
200
OK


422
JSON error message


patch/batches/{id}
Request samples 
application/vnd.api+json
{
  • "data": {
    }
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Account Add Tags
Bulk Action


Adds tags to the accounts targeted by the query parameters (default: ALL) using the {tags} array of strings passed in request body


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/accountAddTags
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Accounts Add Assignments
Bulk Action


Adds assignments to the accounts targeted by the query parameters (default: ALL) using the {userIds} array of strings passed in request body


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/accountsAddAssignments
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Accounts Assign Owner
Bulk Action


assign an user with {ownerId} as owner to all the targeted accounts 


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/accountsAssignOwner
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Accounts Bulk Modify
Bulk Action


Modifies the accounts targeted by the query parameters (default: ALL) using the {field: value, ...} pairs passed in request body.


Alternative request body for a single field modification is also supported:


{
    "data": {
        "attributes": {
            "fieldName": "string",
            "fieldValue": "string",
            "ids": [0]
        }
    },
    "type": "string"
}



SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/accountsBulkModify
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Accounts Destroy All
Bulk Action


Deletes the accounts targeted by the query parameters (default: ALL)


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/accountsDestroyAll
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Accounts Remove All Assignments
Bulk Action


Removes all assignments from the accounts targeted by the query parameters (default: ALL)


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/accountsRemoveAllAssignments
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Accounts Remove Assignments
Bulk Action


Removes assignments from the accounts targeted by the query parameters (default: ALL) using the {userIds} array of strings passed in request body


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/accountsRemoveAssignments
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Accounts Remove Tags
Bulk Action


Removes tags from the accounts targeted by the query parameters (default: ALL) using the {tags} array of strings passed in request body


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/accountsRemoveTags
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Custom Object Bulk Delete
Bulk Action


Action to delete custom objects of type selected by the query parameter {objectName} 


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/customObjectBulkDelete
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Custom Object Bulk Modify
Bulk Action


Action to modify custom objects of type selected by the query parameter {objectName} 


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/customObjectBulkModify
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Prospects Add Assignments
Bulk Action


Adds assignments to the prospects targeted by the query parameters (default: ALL) using the {userIds} array of strings passed in request body


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/prospectsAddAssignments
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Prospects Add Tags
Bulk Action


Adds tags to the prospects targeted by the query parameters (default: ALL) using the {tags} array of strings passed in request body


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/prospectsAddTags
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Prospects Add To Sequence
Bulk Action


Add Prospects To Sequence


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/prospectsAddToSequence
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Prospects Assign Account
Bulk Action


Sets the account to the prospects targeted by the query parameters (default: ALL) using the {accountId} which specifies the account to add to the prospects


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/prospectsAssignAccount
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Prospects Assign Opportunity
Bulk Action


Sets the opportunity to the prospects targeted by the query parameters (default: ALL) using the {opportunityId} which specifies the account to add to the prospects


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/prospectsAssignOpportunity
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Prospects Assign Owner
Bulk Action


assign an user with {ownerId} as owner to all the targeted prospects 


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/prospectsAssignOwner
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Prospects Bulk Modify
Bulk Action


Modifies the prospects targeted by the query parameters (default: ALL) using the {field: value, ...} pairs passed in request body


Alternative request body for a single field modification is also supported:


{
    "data": {
        "attributes": {
            "fieldName": "string",
            "fieldValue": "string",
            "ids": [0]
        }
    },
    "type": "string"
}



SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/prospectsBulkModify
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Prospects Destroy All
Bulk Action


Deletes the prospects targeted by the query parameters (default: ALL)


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/prospectsDestroyAll
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Prospects Finish All
Bulk Action


For all prospects targeted by the query parameters (default: ALL), attempt to finish the associated prospect sequence


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/prospectsFinishAll
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Prospects Pause All
Bulk Action


For all prospects targeted by the query parameters (default: ALL), attempt to pause the associated prospect sequence


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/prospectsPauseAll
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Prospects Remove All Assignments
Bulk Action


Removes all assignments from the prospects targeted by the query parameters (default: ALL)


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/prospectsRemoveAllAssignments
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Prospects Remove Assignments
Bulk Action


Removes assignments from the prospects targeted by the query parameters (default: ALL) using the {userIds} array of strings passed in request body


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/prospectsRemoveAssignments
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}
Prospects Remove Tags
Bulk Action


Removes tags from the prospects targeted by the query parameters (default: ALL) using the {tags} array of strings passed in request body


SecuritybearerAuth 
Request 
query Parameters
object
 
Request Body schema: application/vnd.api+json
object
 
type
string
 
Responses 
200
OK


422
JSON error message


post/batches/actions/prospectsRemoveTags
Request samples 
application/vnd.api+json
{
  • "data": {
    },
  • "type": "string"
}
Response samples 
application/vnd.api+json
{
  • "data": {
    }
}