{
"item": [
{
"id": "d6a6b0f1-a18f-4ba5-b6d9-a62c8a28abe2",
"name": "Tasks",
"description": {
"content": "Create and search tasks for your go-to-market workflows.",
"type": "text/plain"
},
"item": [
{
"id": "dd4de0d8-1f20-40df-b9af-018b4d54b601",
"name": "Create a Task",
"request": {
"name": "Create a Task",
"description": {
"content": "## Endpoint essentials\n\n**API key access:** `api/v1/tasks/create` or `Master API key`\n\n**OAuth scopes:** `tasks_create`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nTasks let you track, prioritize, and help you complete actions required for your outbound sales motion.
Use the Create a Task endpoint to create a single task in Apollo for you and your team. Tasks help track the upcoming actions you need to take, such as emailing or calling a contact.
This endpoint returns the created task object.
Apollo does not apply deduplication processes when you create a new task via the API. If your entry has the same task owner, contact, and other details as an existing task, Apollo will create a new task instead of updating the existing task.",
"type": "text/plain"
},
"url": {
"path": [
"tasks"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": []
},
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"auth": null,
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"\",\n \"contact_id\": \"\",\n \"type\": \"\",\n \"status\": \"\",\n \"due_at\": \"\",\n \"priority\": \"medium\",\n \"title\": \"\",\n \"note\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"response": [
{
"id": "de06681b-85cc-4120-bc15-49b1e044248e",
"name": "200",
"originalRequest": {
"url": {
"path": [
"tasks"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"contact_id\": \"66e34b81740c50074e3d1bd4\",\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"due_at\": \"2025-02-15T10:00:00Z\",\n \"title\": \"Follow-up call\",\n \"note\": \"Discuss product demo results and next steps.\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "OK",
"code": 200,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"task\": {\n \"emailer_campaign_id\": null,\n \"id\": \"67a1b2c3d4e5f60001234567\",\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2025-02-03T15:30:00.000Z\",\n \"completed_at\": null,\n \"note\": \"Discuss product demo results and next steps.\",\n \"skipped_at\": null,\n \"due_at\": \"2025-02-15T10:00:00.000+00:00\",\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"answered\": null,\n \"contact_id\": \"66e34b81740c50074e3d1bd4\",\n \"person_id\": \"66e34b81740c50074e3d1bd5\",\n \"account_id\": \"612f9d6cd26c290001d9bda0\",\n \"organization_id\": \"5fc93db64c38d300d6aa24e6\",\n \"persona_ids\": [],\n \"subject\": null,\n \"created_from\": \"api\",\n \"salesforce_type\": null,\n \"playbook_step_ids\": [],\n \"playbook_id\": null,\n \"needs_playbook_autoprospecting\": null,\n \"starred_by_user_ids\": [],\n \"salesforce_id\": null,\n \"hubspot_id\": null,\n \"opportunity_id\": null,\n \"title\": \"Follow-up call with John Smith\",\n \"rule_config_id\": null,\n \"creator_id\": \"66302798d03b9601c7934ebf\",\n \"contact\": {\n \"id\": \"66e34b81740c50074e3d1bd4\",\n \"first_name\": \"John\",\n \"last_name\": \"Smith\",\n \"name\": \"John Smith\",\n \"linkedin_url\": \"https://www.linkedin.com/in/john-smith-6b2d9f84\",\n \"title\": \"VP of Sales\",\n \"email\": \"john.smith@example.com\",\n \"organization_name\": \"Example Corp\",\n \"photo_url\": null,\n \"twitter_url\": null,\n \"github_url\": null,\n \"facebook_url\": null,\n \"account_id\": \"612f9d6cd26c290001d9bda0\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2024-09-12T18:45:21.456Z\",\n \"present_raw_address\": \"San Francisco, CA\",\n \"city\": \"San Francisco\",\n \"state\": \"California\",\n \"country\": \"United States\",\n \"email_status\": \"verified\"\n },\n \"account\": {\n \"id\": \"612f9d6cd26c290001d9bda0\",\n \"name\": \"Example Corp\",\n \"domain\": \"example.com\",\n \"team_id\": \"6095a710bd01d100a506d4ac\",\n \"organization_id\": \"5fc93db64c38d300d6aa24e6\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2021-09-01T15:34:04.371Z\",\n \"phone\": \"+1 (555) 555-0164\",\n \"phone_status\": \"no_status\",\n \"linkedin_url\": \"https://www.linkedin.com/company/example-corp\"\n }\n }\n}",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "9b1917b6-5154-45fc-a7b9-b5ba3efc53dd",
"name": "401",
"originalRequest": {
"url": {
"path": [
"tasks"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "text/plain"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"contact_id\": \"66e34b81740c50074e3d1bd4\",\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"due_at\": \"2025-02-15T10:00:00Z\",\n \"title\": \"Follow-up call\",\n \"note\": \"Discuss product demo results and next steps.\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Unauthorized",
"code": 401,
"header": [
{
"key": "Content-Type",
"value": "text/plain"
}
],
"body": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.",
"cookie": [],
"_postman_previewlanguage": "text"
},
{
"id": "dd307981-5664-4e7f-9953-2ed1afc16770",
"name": "403",
"originalRequest": {
"url": {
"path": [
"tasks"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"contact_id\": \"66e34b81740c50074e3d1bd4\",\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"due_at\": \"2025-02-15T10:00:00Z\",\n \"title\": \"Follow-up call\",\n \"note\": \"Discuss product demo results and next steps.\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Forbidden",
"code": 403,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"This API key is not authorized to access api/v1/tasks. Request an API key from your administrator that includes this endpoint in its configured scope.\\\",\\n \\\"error_code\\\": \\\"API_INACCESSIBLE\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "73673ca8-188a-4ca8-aba2-bc048c0aa6fc",
"name": "422",
"originalRequest": {
"url": {
"path": [
"tasks"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"contact_id\": \"66e34b81740c50074e3d1bd4\",\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"due_at\": \"2025-02-15T10:00:00Z\",\n \"title\": \"Follow-up call\",\n \"note\": \"Discuss product demo results and next steps.\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Unprocessable Entity (WebDAV) (RFC 4918)",
"code": 422,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"type and user can not be blank\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "ed0dd387-3e14-49c6-b1fc-4cb25e7bba93",
"name": "429",
"originalRequest": {
"url": {
"path": [
"tasks"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"contact_id\": \"66e34b81740c50074e3d1bd4\",\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"due_at\": \"2025-02-15T10:00:00Z\",\n \"title\": \"Follow-up call\",\n \"note\": \"Discuss product demo results and next steps.\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Too Many Requests",
"code": 429,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"message\\\": \\\"The maximum number of api calls allowed for api/v1/tasks is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
}
],
"event": [],
"protocolProfileBehavior": {
"disableBodyPruning": true
}
},
{
"id": "aef47720-5fa7-4195-a67f-5e0a62b2bfac",
"name": "Bulk Create Tasks",
"request": {
"name": "Bulk Create Tasks",
"description": {
"content": "## Endpoint essentials\n\n**API key access:** `api/v1/tasks/bulk_create` or `Master API key`\n\n**OAuth scopes:** `tasks_create`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\n**Authentication note:** Shares scope with `tasks/create`.\n\nTasks let you track, prioritize, and help you complete actions required for your outbound sales motion.
Use the Bulk Create Tasks endpoint to create multiple tasks in a single API request. A separate task will be created for each contact provided.
This endpoint returns a `success` boolean and a `tasks` array containing the created tasks.
Apollo doesn't apply deduplication processes when you create a new task via the API. If your entry has the same task owner, contact, and other details as an existing task, Apollo creates a new task instead of updating the existing task.
For creating a single task, use the Create a Task endpoint instead.",
"type": "text/plain"
},
"url": {
"path": [
"tasks",
"bulk_create"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": []
},
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"auth": null,
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"\",\n \"contact_ids\": [\n \"\",\n \"\"\n ],\n \"type\": \"\",\n \"status\": \"\",\n \"due_at\": \"\",\n \"priority\": \"medium\",\n \"note\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"response": [
{
"id": "2942b4ab-e152-46e6-95f5-a29fc46db60f",
"name": "200",
"originalRequest": {
"url": {
"path": [
"tasks",
"bulk_create"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"contact_ids\": [\n \"66e34b81740c50074e3d1bd4\",\n \"66e34b81740c50074e3d1bd5\",\n \"66e34b81740c50074e3d1bd6\"\n ],\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"due_at\": \"2025-02-15T10:00:00Z\",\n \"note\": \"Follow up on demo request.\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "OK",
"code": 200,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"tasks\": [\n {\n \"emailer_campaign_id\": null,\n \"id\": \"67a1b2c3d4e5f60001234567\",\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2025-02-03T15:30:00.000Z\",\n \"completed_at\": null,\n \"note\": \"Discuss product demo results and next steps.\",\n \"skipped_at\": null,\n \"due_at\": \"2025-02-15T10:00:00.000+00:00\",\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"answered\": null,\n \"contact_id\": \"66e34b81740c50074e3d1bd4\",\n \"person_id\": \"66e34b81740c50074e3d1bd5\",\n \"account_id\": \"612f9d6cd26c290001d9bda0\",\n \"organization_id\": \"5fc93db64c38d300d6aa24e6\",\n \"persona_ids\": [],\n \"subject\": null,\n \"created_from\": \"api\",\n \"salesforce_type\": null,\n \"playbook_step_ids\": [],\n \"playbook_id\": null,\n \"needs_playbook_autoprospecting\": null,\n \"starred_by_user_ids\": [],\n \"salesforce_id\": null,\n \"hubspot_id\": null,\n \"opportunity_id\": null,\n \"title\": \"Follow-up call with John Smith\",\n \"rule_config_id\": null,\n \"creator_id\": \"66302798d03b9601c7934ebf\",\n \"contact\": {\n \"id\": \"66e34b81740c50074e3d1bd4\",\n \"first_name\": \"John\",\n \"last_name\": \"Smith\",\n \"name\": \"John Smith\",\n \"linkedin_url\": \"https://www.linkedin.com/in/john-smith-6b2d9f84\",\n \"title\": \"VP of Sales\",\n \"email\": \"john.smith@example.com\",\n \"organization_name\": \"Example Corp\",\n \"photo_url\": null,\n \"twitter_url\": null,\n \"github_url\": null,\n \"facebook_url\": null,\n \"account_id\": \"612f9d6cd26c290001d9bda0\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2024-09-12T18:45:21.456Z\",\n \"present_raw_address\": \"San Francisco, CA\",\n \"city\": \"San Francisco\",\n \"state\": \"California\",\n \"country\": \"United States\",\n \"email_status\": \"verified\"\n },\n \"account\": {\n \"id\": \"612f9d6cd26c290001d9bda0\",\n \"name\": \"Example Corp\",\n \"domain\": \"example.com\",\n \"team_id\": \"6095a710bd01d100a506d4ac\",\n \"organization_id\": \"5fc93db64c38d300d6aa24e6\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2021-09-01T15:34:04.371Z\",\n \"phone\": \"+1 (555) 555-0164\",\n \"phone_status\": \"no_status\",\n \"linkedin_url\": \"https://www.linkedin.com/company/example-corp\"\n }\n },\n {\n \"emailer_campaign_id\": null,\n \"id\": \"67a1b2c3d4e5f60001234568\",\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2025-02-03T15:30:00.000Z\",\n \"completed_at\": null,\n \"note\": \"Discuss product demo results and next steps.\",\n \"skipped_at\": null,\n \"due_at\": \"2025-02-15T10:00:00.000+00:00\",\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"answered\": null,\n \"contact_id\": \"66e34b81740c50074e3d1bd5\",\n \"person_id\": \"66e34b81740c50074e3d1bd5\",\n \"account_id\": \"612f9d6cd26c290001d9bda0\",\n \"organization_id\": \"5fc93db64c38d300d6aa24e6\",\n \"persona_ids\": [],\n \"subject\": null,\n \"created_from\": \"api\",\n \"salesforce_type\": null,\n \"playbook_step_ids\": [],\n \"playbook_id\": null,\n \"needs_playbook_autoprospecting\": null,\n \"starred_by_user_ids\": [],\n \"salesforce_id\": null,\n \"hubspot_id\": null,\n \"opportunity_id\": null,\n \"title\": \"Follow-up call with Jane Doe\",\n \"rule_config_id\": null,\n \"creator_id\": \"66302798d03b9601c7934ebf\",\n \"contact\": {\n \"id\": \"66e34b81740c50074e3d1bd5\",\n \"first_name\": \"Jane\",\n \"last_name\": \"Doe\",\n \"name\": \"Jane Doe\",\n \"linkedin_url\": \"https://www.linkedin.com/in/john-smith-6b2d9f84\",\n \"title\": \"Director of Marketing\",\n \"email\": \"jane.doe@example.com\",\n \"organization_name\": \"Example Corp\",\n \"photo_url\": null,\n \"twitter_url\": null,\n \"github_url\": null,\n \"facebook_url\": null,\n \"account_id\": \"612f9d6cd26c290001d9bda0\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2024-09-12T18:45:21.456Z\",\n \"present_raw_address\": \"San Francisco, CA\",\n \"city\": \"San Francisco\",\n \"state\": \"California\",\n \"country\": \"United States\",\n \"email_status\": \"verified\"\n },\n \"account\": {\n \"id\": \"612f9d6cd26c290001d9bda0\",\n \"name\": \"Example Corp\",\n \"domain\": \"example.com\",\n \"team_id\": \"6095a710bd01d100a506d4ac\",\n \"organization_id\": \"5fc93db64c38d300d6aa24e6\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2021-09-01T15:34:04.371Z\",\n \"phone\": \"+1 (555) 555-0164\",\n \"phone_status\": \"no_status\",\n \"linkedin_url\": \"https://www.linkedin.com/company/example-corp\"\n }\n }\n ]\n}",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "ec6142dd-8f69-47e2-b1ac-07d6c0a71307",
"name": "401",
"originalRequest": {
"url": {
"path": [
"tasks",
"bulk_create"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "text/plain"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"contact_ids\": [\n \"66e34b81740c50074e3d1bd4\",\n \"66e34b81740c50074e3d1bd5\",\n \"66e34b81740c50074e3d1bd6\"\n ],\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"due_at\": \"2025-02-15T10:00:00Z\",\n \"note\": \"Follow up on demo request.\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Unauthorized",
"code": 401,
"header": [
{
"key": "Content-Type",
"value": "text/plain"
}
],
"body": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.",
"cookie": [],
"_postman_previewlanguage": "text"
},
{
"id": "cab04c83-341d-462c-a6f2-d8cd989b263a",
"name": "403",
"originalRequest": {
"url": {
"path": [
"tasks",
"bulk_create"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"contact_ids\": [\n \"66e34b81740c50074e3d1bd4\",\n \"66e34b81740c50074e3d1bd5\",\n \"66e34b81740c50074e3d1bd6\"\n ],\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"due_at\": \"2025-02-15T10:00:00Z\",\n \"note\": \"Follow up on demo request.\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Forbidden",
"code": 403,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"This API key is not authorized to access api/v1/tasks/bulk_create. Request an API key from your administrator that includes this endpoint in its configured scope.\\\",\\n \\\"error_code\\\": \\\"API_INACCESSIBLE\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "ab799bd7-1c3d-4aaa-839b-fe277a114c20",
"name": "422",
"originalRequest": {
"url": {
"path": [
"tasks",
"bulk_create"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"contact_ids\": [\n \"66e34b81740c50074e3d1bd4\",\n \"66e34b81740c50074e3d1bd5\",\n \"66e34b81740c50074e3d1bd6\"\n ],\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"due_at\": \"2025-02-15T10:00:00Z\",\n \"note\": \"Follow up on demo request.\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Unprocessable Entity (WebDAV) (RFC 4918)",
"code": 422,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"type and user can not be blank\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "4af512e4-947f-4ca8-a7d9-127491e2c184",
"name": "429",
"originalRequest": {
"url": {
"path": [
"tasks",
"bulk_create"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"contact_ids\": [\n \"66e34b81740c50074e3d1bd4\",\n \"66e34b81740c50074e3d1bd5\",\n \"66e34b81740c50074e3d1bd6\"\n ],\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"due_at\": \"2025-02-15T10:00:00Z\",\n \"note\": \"Follow up on demo request.\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Too Many Requests",
"code": 429,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"message\\\": \\\"The maximum number of api calls allowed for api/v1/tasks/bulk_create is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
}
],
"event": [],
"protocolProfileBehavior": {
"disableBodyPruning": true
}
},
{
"id": "9b99e251-a7f4-48cf-a65f-8dedd7171c17",
"name": "Get a Task",
"request": {
"name": "Get a Task",
"description": {
"content": "## Endpoint essentials\n\n**API key access:** `api/v1/tasks/show` or `Master API key`\n\n**OAuth scopes:** `tasks_list`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nTasks let you track, prioritize, and help you complete actions required for your outbound sales motion.
Use the Get a Task endpoint to retrieve the full details for a single task that belongs to your team's Apollo account.
The response includes the task's associated account and contact when the task has one attached. Depending on the task's `type` and how it was created, the response can also include additional fields, such as `phone_call` for call tasks, `emailer_message` for email tasks, or a LinkedIn message template for LinkedIn-step tasks.
To find task IDs, use the Search for Tasks endpoint and identify the `id` value for the task you want to view.
To create a task, use the Create a Task endpoint instead.",
"type": "text/plain"
},
"url": {
"path": [
"tasks",
":id"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"method": "GET",
"auth": null
},
"response": [
{
"id": "c095e151-1475-4fb4-993c-9ec2239fea6f",
"name": "200",
"originalRequest": {
"url": {
"path": [
"tasks",
":id"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "GET",
"body": {}
},
"status": "OK",
"code": 200,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"task\": {\n \"emailer_campaign_id\": null,\n \"id\": \"67a1b2c3d4e5f60001234567\",\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2024-09-12T18:45:21.456Z\",\n \"completed_at\": null,\n \"note\": \"Discuss product demo results and next steps.\",\n \"skipped_at\": null,\n \"due_at\": \"2025-02-15T10:00:00.000+00:00\",\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"answered\": null,\n \"contact_id\": \"66e34b81740c50074e3d1bd4\",\n \"person_id\": null,\n \"account_id\": \"612f9d6cd26c290001d9bda0\",\n \"organization_id\": \"5fc93db64c38d300d6aa24e6\",\n \"persona_ids\": [],\n \"subject\": null,\n \"created_from\": \"api\",\n \"salesforce_type\": null,\n \"playbook_step_ids\": [],\n \"playbook_id\": null,\n \"needs_playbook_autoprospecting\": null,\n \"starred_by_user_ids\": [],\n \"salesforce_id\": null,\n \"hubspot_id\": null,\n \"opportunity_id\": null,\n \"title\": \"Follow-up call with John Smith\",\n \"rule_config_id\": null,\n \"creator_id\": \"66302798d03b9601c7934ebf\",\n \"completed_by_user_id\": null,\n \"call_script\": null,\n \"relevant_fields\": null,\n \"pending_send\": false,\n \"ai_variables_status\": null,\n \"recommended\": false,\n \"recommendation_reasons\": [],\n \"note_text\": \"Discuss product demo results and next steps.\",\n \"phone_call\": {\n \"id\": \"66e8cc45028aed019c25d720\",\n \"answered\": true,\n \"created_at\": \"2024-09-17T00:24:37.436Z\",\n \"phone_call_outcome_id\": null,\n \"phone_call_purpose_id\": null,\n \"to_number\": \"+1 (555) 555-****\"\n },\n \"account\": {\n \"id\": \"612f9d6cd26c290001d9bda0\",\n \"name\": \"Example Corp\",\n \"website_url\": \"http://www.example.com\",\n \"domain\": \"example.com\",\n \"linkedin_url\": \"https://www.linkedin.com/company/example-corp\",\n \"linkedin_uid\": \"18511550\",\n \"phone\": \"+1 (555) 555-0164\",\n \"phone_status\": \"no_status\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": null,\n \"organization_id\": \"5fc93db64c38d300d6aa24e6\",\n \"industry\": \"information technology & services\",\n \"estimated_num_employees\": 910,\n \"label_ids\": [],\n \"typed_custom_fields\": {},\n \"account_queues\": [],\n \"created_at\": \"2021-09-01T15:34:04.371Z\"\n },\n \"contact\": {\n \"id\": \"66e34b81740c50074e3d1bd4\",\n \"first_name\": \"John\",\n \"last_name\": \"Smith\",\n \"name\": \"John Smith\",\n \"email\": \"john.smith@example.com\",\n \"title\": \"VP of Sales\",\n \"organization_name\": \"Example Corp\",\n \"account_id\": \"612f9d6cd26c290001d9bda0\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"contact_stage_id\": null,\n \"linkedin_url\": \"https://www.linkedin.com/in/john-smith-6b2d9f84\",\n \"phone_numbers\": [],\n \"contact_emails\": [\n {\n \"email\": \"john.smith@example.com\",\n \"email_status\": \"verified\"\n }\n ],\n \"typed_custom_fields\": {},\n \"label_ids\": [],\n \"created_at\": \"2024-09-12T18:45:21.456Z\",\n \"updated_at\": \"2024-09-17T00:24:37.436Z\"\n },\n \"relevant_field_values\": {}\n }\n}",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "36455ca9-174f-4cc2-863c-08151e3dc990",
"name": "401",
"originalRequest": {
"url": {
"path": [
"tasks",
":id"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "text/plain"
}
],
"method": "GET",
"body": {}
},
"status": "Unauthorized",
"code": 401,
"header": [
{
"key": "Content-Type",
"value": "text/plain"
}
],
"body": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.",
"cookie": [],
"_postman_previewlanguage": "text"
},
{
"id": "b711a9a9-dedb-4fac-9b56-1635d9efb8c5",
"name": "403",
"originalRequest": {
"url": {
"path": [
"tasks",
":id"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "GET",
"body": {}
},
"status": "Forbidden",
"code": 403,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"This API key is not authorized to access api/v1/tasks/show. Request an API key from your administrator that includes this endpoint in its configured scope.\\\",\\n \\\"error_code\\\": \\\"API_INACCESSIBLE\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "2957be87-7bec-4561-9236-e82fb916507c",
"name": "422",
"originalRequest": {
"url": {
"path": [
"tasks",
":id"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "GET",
"body": {}
},
"status": "Unprocessable Entity (WebDAV) (RFC 4918)",
"code": 422,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"This task or emailer message has been deleted. Please refresh your page.\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "6e4d7907-7b43-4608-ba58-87bb15398f93",
"name": "429",
"originalRequest": {
"url": {
"path": [
"tasks",
":id"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "GET",
"body": {}
},
"status": "Too Many Requests",
"code": 429,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"message\\\": \\\"The maximum number of api calls allowed for api/v1/tasks/show is 200 times per minute. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
}
],
"event": [],
"protocolProfileBehavior": {
"disableBodyPruning": true
}
},
{
"id": "e2a19fd5-f5b4-4149-98b0-a2fcf17e1151",
"name": "Update a Task",
"request": {
"name": "Update a Task",
"description": {
"content": "## Endpoint essentials\n\n**API key access:** `api/v1/tasks/update` or `Master API key`\n\n**OAuth scopes:** `tasks_create`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nTasks let you track, prioritize, and help you complete actions required for your outbound sales motion.
Use the Update a Task endpoint to change the details of an existing task that belongs to your team's Apollo account.
To find task IDs, use the Search for Tasks endpoint and identify the `id` value for the task you want to update.
The fields you can update depend on the task's current `status`. For a task with a `scheduled` status, you can update any of the parameters listed below. For a task that's already `completed` or `skipped`, you can only update `note`, `priority`, `priority_cd`, and `contact_id`.
To mark a task as done, use the Complete a Task or Skip a Task endpoints instead of setting `status` here.\n\n> ⚠️ Omitting `priority` or `creator_id` resets them\n>\n> If the task you're updating has a `scheduled` status, and your request doesn't include a `priority` or `creator_id` parameter, Apollo resets `priority` to `medium` and `creator_id` to the user associated with your API key — even if you didn't intend to change those fields. To avoid this, always include the task's current `priority` and `creator_id` in every update request, even when you're only changing an unrelated field like `note`.",
"type": "text/plain"
},
"url": {
"path": [
"tasks",
":id"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "PATCH",
"auth": null,
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"\",\n \"creator_id\": \"\",\n \"contact_id\": \"\",\n \"note\": \"\",\n \"type\": \"\",\n \"priority\": \"medium\",\n \"priority_cd\": {},\n \"status\": \"\",\n \"due_at\": \"\",\n \"title\": \"\",\n \"call_script\": \"\",\n \"relevant_fields\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"response": [
{
"id": "79081cae-cdfe-4115-97ff-d2f2dc53a38a",
"name": "200",
"originalRequest": {
"url": {
"path": [
"tasks",
":id"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "PATCH",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"\",\n \"creator_id\": \"\",\n \"contact_id\": \"\",\n \"note\": \"\",\n \"type\": \"\",\n \"priority\": \"medium\",\n \"priority_cd\": {},\n \"status\": \"\",\n \"due_at\": \"\",\n \"title\": \"\",\n \"call_script\": \"\",\n \"relevant_fields\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "OK",
"code": 200,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"task\": {\n \"emailer_campaign_id\": null,\n \"id\": \"67a1b2c3d4e5f60001234567\",\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2024-09-12T18:45:21.456Z\",\n \"completed_at\": null,\n \"note\": \"Discuss product demo results and next steps.\",\n \"skipped_at\": null,\n \"due_at\": \"2025-02-15T10:00:00.000+00:00\",\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"answered\": null,\n \"contact_id\": \"66e34b81740c50074e3d1bd4\",\n \"person_id\": null,\n \"account_id\": \"612f9d6cd26c290001d9bda0\",\n \"organization_id\": \"5fc93db64c38d300d6aa24e6\",\n \"persona_ids\": [],\n \"subject\": null,\n \"created_from\": \"api\",\n \"salesforce_type\": null,\n \"playbook_step_ids\": [],\n \"playbook_id\": null,\n \"needs_playbook_autoprospecting\": null,\n \"starred_by_user_ids\": [],\n \"salesforce_id\": null,\n \"hubspot_id\": null,\n \"opportunity_id\": null,\n \"title\": \"Follow-up call with John Smith\",\n \"rule_config_id\": null,\n \"creator_id\": \"66302798d03b9601c7934ebf\",\n \"completed_by_user_id\": null,\n \"call_script\": null,\n \"relevant_fields\": null,\n \"pending_send\": false,\n \"ai_variables_status\": null,\n \"recommended\": false,\n \"recommendation_reasons\": [],\n \"note_text\": \"Discuss product demo results and next steps.\",\n \"phone_call\": {\n \"id\": \"66e8cc45028aed019c25d720\",\n \"answered\": true,\n \"created_at\": \"2024-09-17T00:24:37.436Z\",\n \"phone_call_outcome_id\": null,\n \"phone_call_purpose_id\": null,\n \"to_number\": \"+1 (555) 555-****\"\n },\n \"account\": {\n \"id\": \"612f9d6cd26c290001d9bda0\",\n \"name\": \"Example Corp\",\n \"website_url\": \"http://www.example.com\",\n \"domain\": \"example.com\",\n \"linkedin_url\": \"https://www.linkedin.com/company/example-corp\",\n \"linkedin_uid\": \"18511550\",\n \"phone\": \"+1 (555) 555-0164\",\n \"phone_status\": \"no_status\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": null,\n \"organization_id\": \"5fc93db64c38d300d6aa24e6\",\n \"industry\": \"information technology & services\",\n \"estimated_num_employees\": 910,\n \"label_ids\": [],\n \"typed_custom_fields\": {},\n \"account_queues\": [],\n \"created_at\": \"2021-09-01T15:34:04.371Z\"\n },\n \"contact\": {\n \"id\": \"66e34b81740c50074e3d1bd4\",\n \"first_name\": \"John\",\n \"last_name\": \"Smith\",\n \"name\": \"John Smith\",\n \"email\": \"john.smith@example.com\",\n \"title\": \"VP of Sales\",\n \"organization_name\": \"Example Corp\",\n \"account_id\": \"612f9d6cd26c290001d9bda0\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"contact_stage_id\": null,\n \"linkedin_url\": \"https://www.linkedin.com/in/john-smith-6b2d9f84\",\n \"phone_numbers\": [],\n \"contact_emails\": [\n {\n \"email\": \"john.smith@example.com\",\n \"email_status\": \"verified\"\n }\n ],\n \"typed_custom_fields\": {},\n \"label_ids\": [],\n \"created_at\": \"2024-09-12T18:45:21.456Z\",\n \"updated_at\": \"2024-09-17T00:24:37.436Z\"\n },\n \"relevant_field_values\": {}\n }\n}",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "37906e93-1dfc-4848-ab3e-3c7adba7d142",
"name": "401",
"originalRequest": {
"url": {
"path": [
"tasks",
":id"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "text/plain"
}
],
"method": "PATCH",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"\",\n \"creator_id\": \"\",\n \"contact_id\": \"\",\n \"note\": \"\",\n \"type\": \"\",\n \"priority\": \"medium\",\n \"priority_cd\": {},\n \"status\": \"\",\n \"due_at\": \"\",\n \"title\": \"\",\n \"call_script\": \"\",\n \"relevant_fields\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Unauthorized",
"code": 401,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"This task belongs to another user. You do not have permissions to modify other people's tasks.\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "c5504259-aa2a-40f4-b79a-f74a770b91c7",
"name": "403",
"originalRequest": {
"url": {
"path": [
"tasks",
":id"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "PATCH",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"\",\n \"creator_id\": \"\",\n \"contact_id\": \"\",\n \"note\": \"\",\n \"type\": \"\",\n \"priority\": \"medium\",\n \"priority_cd\": {},\n \"status\": \"\",\n \"due_at\": \"\",\n \"title\": \"\",\n \"call_script\": \"\",\n \"relevant_fields\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Forbidden",
"code": 403,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"This API key is not authorized to access api/v1/tasks/update. Request an API key from your administrator that includes this endpoint in its configured scope.\\\",\\n \\\"error_code\\\": \\\"API_INACCESSIBLE\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "d48c8fe0-75bb-4d5c-8048-9da43bd6011c",
"name": "422",
"originalRequest": {
"url": {
"path": [
"tasks",
":id"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "PATCH",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"\",\n \"creator_id\": \"\",\n \"contact_id\": \"\",\n \"note\": \"\",\n \"type\": \"\",\n \"priority\": \"medium\",\n \"priority_cd\": {},\n \"status\": \"\",\n \"due_at\": \"\",\n \"title\": \"\",\n \"call_script\": \"\",\n \"relevant_fields\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Unprocessable Entity (WebDAV) (RFC 4918)",
"code": 422,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"This task has been deleted. Please refresh your page.\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "c7538aed-b055-4d97-80a5-4e986c5b7957",
"name": "429",
"originalRequest": {
"url": {
"path": [
"tasks",
":id"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "PATCH",
"body": {
"mode": "raw",
"raw": "{\n \"user_id\": \"\",\n \"creator_id\": \"\",\n \"contact_id\": \"\",\n \"note\": \"\",\n \"type\": \"\",\n \"priority\": \"medium\",\n \"priority_cd\": {},\n \"status\": \"\",\n \"due_at\": \"\",\n \"title\": \"\",\n \"call_script\": \"\",\n \"relevant_fields\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Too Many Requests",
"code": 429,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"message\\\": \\\"The maximum number of api calls allowed for api/v1/tasks/update is 200 times per minute. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
}
],
"event": [],
"protocolProfileBehavior": {
"disableBodyPruning": true
}
},
{
"id": "e824770c-29bc-4c8e-ad98-229fcd07ca31",
"name": "Complete a Task",
"request": {
"name": "Complete a Task",
"description": {
"content": "## Endpoint essentials\n\n**API key access:** `api/v1/tasks/complete` or `Master API key`\n\n**OAuth scopes:** `tasks_create`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nTasks let you track, prioritize, and help you complete actions required for your outbound sales motion.
Use the Complete a Task endpoint to mark an existing task as `completed`.
To find task IDs, use the Search for Tasks endpoint and identify the `id` value for the task you want to complete.
If the task no longer exists (for example, because the sequence it belonged to was paused and the task was removed), Apollo still returns a `200` response, with `deleted: true` on the task, instead of an error.
To skip a task instead of completing it, use the Skip a Task endpoint.
Calling this endpoint on a task that's already `completed` or `skipped` returns a `422` response.",
"type": "text/plain"
},
"url": {
"path": [
"tasks",
":id",
"complete"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"auth": null,
"body": {
"mode": "raw",
"raw": "{\n \"note\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"response": [
{
"id": "6ae2a9f4-ac10-473e-98d8-e80bcaac413e",
"name": "200",
"originalRequest": {
"url": {
"path": [
"tasks",
":id",
"complete"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"note\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "OK",
"code": 200,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"task\": {\n \"emailer_campaign_id\": null,\n \"id\": \"67a1b2c3d4e5f60001234567\",\n \"user_id\": \"66302798d03b9601c7934ebf\",\n \"created_at\": \"2024-09-12T18:45:21.456Z\",\n \"completed_at\": null,\n \"note\": \"Discuss product demo results and next steps.\",\n \"skipped_at\": null,\n \"due_at\": \"2025-02-15T10:00:00.000+00:00\",\n \"type\": \"call\",\n \"priority\": \"high\",\n \"status\": \"scheduled\",\n \"answered\": null,\n \"contact_id\": \"66e34b81740c50074e3d1bd4\",\n \"person_id\": null,\n \"account_id\": \"612f9d6cd26c290001d9bda0\",\n \"organization_id\": \"5fc93db64c38d300d6aa24e6\",\n \"persona_ids\": [],\n \"subject\": null,\n \"created_from\": \"api\",\n \"salesforce_type\": null,\n \"playbook_step_ids\": [],\n \"playbook_id\": null,\n \"needs_playbook_autoprospecting\": null,\n \"starred_by_user_ids\": [],\n \"salesforce_id\": null,\n \"hubspot_id\": null,\n \"opportunity_id\": null,\n \"title\": \"Follow-up call with John Smith\",\n \"rule_config_id\": null,\n \"creator_id\": \"66302798d03b9601c7934ebf\",\n \"completed_by_user_id\": null,\n \"call_script\": null,\n \"relevant_fields\": null,\n \"pending_send\": false,\n \"ai_variables_status\": null,\n \"recommended\": false,\n \"recommendation_reasons\": [],\n \"phone_call\": {\n \"id\": \"66e8cc45028aed019c25d720\",\n \"answered\": true,\n \"created_at\": \"2024-09-17T00:24:37.436Z\",\n \"phone_call_outcome_id\": null,\n \"phone_call_purpose_id\": null,\n \"to_number\": \"+1 (555) 555-****\"\n },\n \"account\": {\n \"id\": \"612f9d6cd26c290001d9bda0\",\n \"name\": \"Example Corp\",\n \"website_url\": \"http://www.example.com\",\n \"domain\": \"example.com\",\n \"linkedin_url\": \"https://www.linkedin.com/company/example-corp\",\n \"linkedin_uid\": \"18511550\",\n \"phone\": \"+1 (555) 555-0164\",\n \"phone_status\": \"no_status\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"account_stage_id\": null,\n \"organization_id\": \"5fc93db64c38d300d6aa24e6\",\n \"industry\": \"information technology & services\",\n \"estimated_num_employees\": 910,\n \"label_ids\": [],\n \"typed_custom_fields\": {},\n \"account_queues\": [],\n \"created_at\": \"2021-09-01T15:34:04.371Z\"\n },\n \"contact\": {\n \"id\": \"66e34b81740c50074e3d1bd4\",\n \"first_name\": \"John\",\n \"last_name\": \"Smith\",\n \"name\": \"John Smith\",\n \"email\": \"john.smith@example.com\",\n \"title\": \"VP of Sales\",\n \"organization_name\": \"Example Corp\",\n \"account_id\": \"612f9d6cd26c290001d9bda0\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"contact_stage_id\": null,\n \"linkedin_url\": \"https://www.linkedin.com/in/john-smith-6b2d9f84\",\n \"phone_numbers\": [],\n \"contact_emails\": [\n {\n \"email\": \"john.smith@example.com\",\n \"email_status\": \"verified\"\n }\n ],\n \"typed_custom_fields\": {},\n \"label_ids\": [],\n \"created_at\": \"2024-09-12T18:45:21.456Z\",\n \"updated_at\": \"2024-09-17T00:24:37.436Z\"\n },\n \"relevant_field_values\": {}\n },\n \"contact\": {\n \"id\": \"66e34b81740c50074e3d1bd4\",\n \"first_name\": \"John\",\n \"last_name\": \"Smith\",\n \"name\": \"John Smith\",\n \"email\": \"john.smith@example.com\",\n \"title\": \"VP of Sales\",\n \"organization_name\": \"Example Corp\",\n \"account_id\": \"612f9d6cd26c290001d9bda0\",\n \"owner_id\": \"66302798d03b9601c7934ebf\",\n \"contact_stage_id\": null,\n \"linkedin_url\": \"https://www.linkedin.com/in/john-smith-6b2d9f84\",\n \"phone_numbers\": [],\n \"contact_emails\": [\n {\n \"email\": \"john.smith@example.com\",\n \"email_status\": \"verified\"\n }\n ],\n \"typed_custom_fields\": {},\n \"label_ids\": [],\n \"created_at\": \"2024-09-12T18:45:21.456Z\",\n \"updated_at\": \"2024-09-17T00:24:37.436Z\"\n }\n}",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "b3a364e5-48d2-450e-acba-139c9cc599e2",
"name": "401",
"originalRequest": {
"url": {
"path": [
"tasks",
":id",
"complete"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "text/plain"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"note\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Unauthorized",
"code": 401,
"header": [
{
"key": "Content-Type",
"value": "text/plain"
}
],
"body": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.",
"cookie": [],
"_postman_previewlanguage": "text"
},
{
"id": "124ab427-1973-4d68-8042-d740fe728f84",
"name": "403",
"originalRequest": {
"url": {
"path": [
"tasks",
":id",
"complete"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"note\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Forbidden",
"code": 403,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"This API key is not authorized to access api/v1/tasks/complete. Request an API key from your administrator that includes this endpoint in its configured scope.\\\",\\n \\\"error_code\\\": \\\"API_INACCESSIBLE\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "65a5a9e1-1259-4e4e-8ea1-c8b2d02102ef",
"name": "422",
"originalRequest": {
"url": {
"path": [
"tasks",
":id",
"complete"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"note\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Unprocessable Entity (WebDAV) (RFC 4918)",
"code": 422,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"This task belongs to another user. Your admin has disabled non-admin users from completing other people's tasks.\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "b581c7b9-b45a-4743-bbb8-87a60cc0b073",
"name": "429",
"originalRequest": {
"url": {
"path": [
"tasks",
":id",
"complete"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"note\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Too Many Requests",
"code": 429,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"message\\\": \\\"The maximum number of api calls allowed for api/v1/tasks/complete is 200 times per minute. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
}
],
"event": [],
"protocolProfileBehavior": {
"disableBodyPruning": true
}
},
{
"id": "567a14cf-749b-41f8-9728-7a3026b3cb10",
"name": "Skip a Task",
"request": {
"name": "Skip a Task",
"description": {
"content": "## Endpoint essentials\n\n**API key access:** `api/v1/tasks/skip` or `Master API key`\n\n**OAuth scopes:** `tasks_create`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nTasks let you track, prioritize, and help you complete actions required for your outbound sales motion.
Use the Skip a Task endpoint to mark an existing task as `skipped` without completing it.
To find task IDs, use the Search for Tasks endpoint and identify the `id` value for the task you want to skip.
If the task no longer exists (for example, because the sequence it belonged to was paused and the task was removed), Apollo still returns a `200` response, with `deleted: true` on the task, instead of an error.
Calling this endpoint on a task that's already `completed` or `skipped` returns a `422` response.
To mark a task as done instead of skipping it, use the Complete a Task endpoint.",
"type": "text/plain"
},
"url": {
"path": [
"tasks",
":id",
"skip"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"auth": null,
"body": {
"mode": "raw",
"raw": "{\n \"note\": \"\",\n \"on_task_page\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"response": [
{
"id": "f6f60d94-a7aa-4e68-ad38-876249c380f9",
"name": "200",
"originalRequest": {
"url": {
"path": [
"tasks",
":id",
"skip"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"note\": \"\",\n \"on_task_page\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "OK",
"code": 200,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"task\": {\n \"id\": \"67a1b2c3d4e5f60001234567\",\n \"status\": \"skipped\",\n \"note\": null,\n \"completed\": false\n }\n}",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "5215bb25-3dc9-4fb9-a22f-0df03483ae4f",
"name": "401",
"originalRequest": {
"url": {
"path": [
"tasks",
":id",
"skip"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "text/plain"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"note\": \"\",\n \"on_task_page\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Unauthorized",
"code": 401,
"header": [
{
"key": "Content-Type",
"value": "text/plain"
}
],
"body": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.",
"cookie": [],
"_postman_previewlanguage": "text"
},
{
"id": "0cf66d17-f33f-421e-ac91-aa8a4efe4358",
"name": "403",
"originalRequest": {
"url": {
"path": [
"tasks",
":id",
"skip"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"note\": \"\",\n \"on_task_page\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Forbidden",
"code": 403,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"This API key is not authorized to access api/v1/tasks/skip. Request an API key from your administrator that includes this endpoint in its configured scope.\\\",\\n \\\"error_code\\\": \\\"API_INACCESSIBLE\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "a7b73fae-0b12-48b5-9fed-29c33501e88b",
"name": "422",
"originalRequest": {
"url": {
"path": [
"tasks",
":id",
"skip"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"note\": \"\",\n \"on_task_page\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Unprocessable Entity (WebDAV) (RFC 4918)",
"code": 422,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"This task belongs to another user. Your admin has disabled non-admins from skipping other people's tasks.\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "b2813d84-df94-402e-9301-5db805eedbd9",
"name": "429",
"originalRequest": {
"url": {
"path": [
"tasks",
":id",
"skip"
],
"host": [
"{{baseUrl}}"
],
"query": [],
"variable": [
{
"disabled": false,
"type": "any",
"value": "",
"key": "id",
"description": "(Required) The Apollo ID for the task.
To find task IDs, call the Search for Tasks endpoint and identify the `id` value for the task.
Example: `67a1b2c3d4e5f60001234567`"
}
]
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {
"mode": "raw",
"raw": "{\n \"note\": \"\",\n \"on_task_page\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Too Many Requests",
"code": 429,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"message\\\": \\\"The maximum number of api calls allowed for api/v1/tasks/skip is 200 times per minute. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
}
],
"event": [],
"protocolProfileBehavior": {
"disableBodyPruning": true
}
},
{
"id": "b6a96772-ca54-4b52-ae64-8d04a0367328",
"name": "Search for Tasks",
"request": {
"name": "Search for Tasks",
"description": {
"content": "## Endpoint essentials\n\n**API key access:** `api/v1/tasks/search` or `Master API key`\n\n**OAuth scopes:** `tasks_list`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nTasks let you track, prioritize, and help you complete actions required for your outbound sales motion.
Use the Search for Tasks endpoint to find tasks that your team has created in Apollo.
To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible.",
"type": "text/plain"
},
"url": {
"path": [
"tasks",
"search"
],
"host": [
"{{baseUrl}}"
],
"query": [
{
"disabled": false,
"key": "sort_by_field",
"value": "",
"description": "Sort the tasks by 1 of the following options: - `task_due_at`: The most future-dated first.
- `task_priority`: The highest priority first.
"
},
{
"disabled": false,
"key": "open_factor_names[]",
"value": "",
"description": "Enter `task_types` for this parameter to return a count of tasks by task type.
When used, the response includes a `\"task_types\": []` array with a `\"count\"` value for each task type."
},
{
"disabled": false,
"key": "open_factor_names[]",
"value": "",
"description": "Enter `task_types` for this parameter to return a count of tasks by task type.
When used, the response includes a `\"task_types\": []` array with a `\"count\"` value for each task type."
},
{
"disabled": false,
"key": "page",
"value": "",
"description": "The page number of the Apollo data that you want to retrieve.
Use this parameter in combination with the `per_page` parameter to make search results for navigable and improve the performance of the endpoint.
Example: `4`"
},
{
"disabled": false,
"key": "per_page",
"value": "",
"description": "The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance.
Use the `page` parameter to search the different pages of data.
Example: `10`"
}
],
"variable": []
},
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"auth": null
},
"response": [
{
"id": "f6b2d866-012d-4f73-a0f5-c6dd1fee45ca",
"name": "200",
"originalRequest": {
"url": {
"path": [
"tasks",
"search"
],
"host": [
"{{baseUrl}}"
],
"query": [
{
"key": "sort_by_field",
"value": ""
},
{
"key": "open_factor_names[]",
"value": ""
},
{
"key": "open_factor_names[]",
"value": ""
},
{
"key": "page",
"value": ""
},
{
"key": "per_page",
"value": ""
}
],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {}
},
"status": "OK",
"code": 200,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"tasks\": [\n {\n \"emailer_campaign_id\": null,\n \"id\": \"66e8cc45028aed019c25d724\",\n \"user_id\": \"66a3d80d4238fe02d2baaaaf\",\n \"created_at\": \"2024-09-17T00:24:37.436Z\",\n \"completed_at\": null,\n \"note\": null,\n \"skipped_at\": null,\n \"due_at\": \"2024-09-21T00:00:00.000+00:00\",\n \"type\": \"action_item\",\n \"priority\": \"medium\",\n \"status\": \"scheduled\",\n \"answered\": null,\n \"contact_id\": null,\n \"person_id\": null,\n \"account_id\": null,\n \"organization_id\": null,\n \"persona_ids\": [],\n \"subject\": null,\n \"created_from\": null,\n \"salesforce_type\": null,\n \"playbook_step_ids\": [],\n \"playbook_id\": null,\n \"needs_playbook_autoprospecting\": null,\n \"starred_by_user_ids\": [],\n \"salesforce_id\": null,\n \"hubspot_id\": null,\n \"opportunity_id\": \"66e8c4567f32a501b2605004\",\n \"title\": \"Reminder - Schedule Demo Call\",\n \"rule_config_id\": null,\n \"creator_id\": \"60affe7d6e270a00f5db6fe4\",\n \"opportunity\": {\n \"id\": \"66e8c4567f32a501b2605004\",\n \"team_id\": \"6095a710bd01d100a506d4ac\",\n \"owner_id\": \"66a3d80d4238fe02d2baaaaf\",\n \"salesforce_owner_id\": null,\n \"amount\": 3000,\n \"closed_date\": \"2024-11-03T00:00:00.000+00:00\",\n \"account_id\": \"612f9d6cd26c290001d9bda0\",\n \"description\": null,\n \"is_closed\": false,\n \"is_won\": null,\n \"name\": \"5 Seats of Acme | $2K | Google\",\n \"stage_name\": null,\n \"opportunity_stage_id\": \"66e4b9b5e5aa6b0e57f078a1\",\n \"source\": \"ui_form\",\n \"salesforce_id\": null,\n \"created_at\": \"2024-09-16T23:50:46.311Z\",\n \"actual_close_date\": null,\n \"next_step\": \"Schedule Demo\",\n \"next_step_date\": null,\n \"closed_lost_reason\": null,\n \"closed_won_reason\": null,\n \"forecast_category\": \"omitted\",\n \"deal_probability\": 50,\n \"created_by_id\": \"60affe7d6e270a00f5db6fe4\",\n \"current_solutions\": null,\n \"deal_source\": null,\n \"manually_updated_probability\": null,\n \"manually_updated_forecast\": null,\n \"crm_id\": null,\n \"crm_record_url\": null,\n \"crm_owner_id\": null,\n \"probability\": null,\n \"opportunity_pipeline_id\": \"66e4b85ce5aa6b03f3f08b6e\",\n \"stage_updated_at\": \"2024-09-17T16:44:07.133+00:00\",\n \"next_step_last_updated_at\": \"2024-09-17T00:03:13.420+00:00\",\n \"exchange_rate_code\": \"USD\",\n \"exchange_rate_value\": 1,\n \"amount_in_team_currency\": 3000,\n \"forecasted_revenue\": 1500,\n \"last_activity_date\": \"2024-09-17T16:44:07.134Z\",\n \"existence_level\": \"full\",\n \"typed_custom_fields\": {\n \"6095a711bd01d100a506d4da\": [\n \"6153414ac0559d00016ce5eb\"\n ],\n \"6095a711bd01d100a506d4dc\": [\n \"6153414ac0559d00016ce5f3\"\n ],\n \"66e4ba346fe95a073461e00e\": [\n \"66e4ba346fe95a073461e00c\"\n ]\n },\n \"opportunity_rule_config_statuses\": [],\n \"opportunity_contact_roles\": [\n {\n \"id\": \"66e8c9d7320e8a01b44f1e82\",\n \"contact_id\": \"665c3338da53130001243ac4\",\n \"is_primary\": true,\n \"created_at\": \"2024-09-17T00:14:15.655Z\",\n \"updated_at\": \"2024-09-17T00:14:15.655Z\",\n \"role\": [\n {\n \"opportunity_contact_role_type_id\": \"64288550ffb0470001cbf2b0\",\n \"crm_role_id\": null,\n \"is_primary\": true,\n \"crm_id\": null\n }\n ]\n }\n ],\n \"currency\": {\n \"name\": \"US Dollar\",\n \"iso_code\": \"USD\",\n \"symbol\": \"$\"\n },\n \"account\": {\n \"id\": \"612f9d6cd26c290001d9bda0\",\n \"domain\": \"google.com\",\n \"name\": \"Google\",\n \"team_id\": \"6095a710bd01d100a506d4ac\",\n \"organization_id\": \"5fc93db64c38d300d6aa24e6\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b9\",\n \"source\": \"csv_import\",\n \"original_source\": \"csv_import\",\n \"creator_id\": null,\n \"owner_id\": null,\n \"created_at\": \"2021-09-01T15:34:04.371Z\",\n \"phone\": null,\n \"phone_status\": \"no_status\",\n \"hubspot_id\": null,\n \"salesforce_id\": null,\n \"crm_owner_id\": null,\n \"parent_account_id\": null,\n \"linkedin_url\": null,\n \"account_playbook_statuses\": [],\n \"account_rule_config_statuses\": [\n {\n \"_id\": \"6466e8047759270001e53509\",\n \"created_at\": null,\n \"rule_action_config_id\": \"64650edd434f8f00a3b13938\",\n \"rule_config_id\": \"64650edd434f8f00a3b13939\",\n \"status_cd\": \"completed\",\n \"updated_at\": null,\n \"id\": \"6466e8047759270001e53509\",\n \"key\": \"6466e8047759270001e53509\"\n },\n {\n \"_id\": \"65735a01fee94b0001245088\",\n \"created_at\": null,\n \"rule_action_config_id\": \"657358b05ed8f1061a6322e7\",\n \"rule_config_id\": \"657358b05ed8f1061a6322e8\",\n \"status_cd\": \"completed\",\n \"updated_at\": null,\n \"id\": \"65735a01fee94b0001245088\",\n \"key\": \"65735a01fee94b0001245088\"\n },\n {\n \"_id\": \"658118c6b2714c0001e4efe5\",\n \"created_at\": null,\n \"rule_action_config_id\": \"6580939a36272f01c6eda909\",\n \"rule_config_id\": \"6580939a36272f01c6eda90b\",\n \"status_cd\": \"completed\",\n \"updated_at\": null,\n \"id\": \"658118c6b2714c0001e4efe5\",\n \"key\": \"658118c6b2714c0001e4efe5\"\n },\n {\n \"_id\": \"66141ad2675f2000072834c5\",\n \"created_at\": null,\n \"rule_action_config_id\": \"65735e0ea63d2700faba5c6e\",\n \"rule_config_id\": \"65735e0ea63d2700faba5c6f\",\n \"status_cd\": \"completed\",\n \"updated_at\": null,\n \"id\": \"66141ad2675f2000072834c5\",\n \"key\": \"66141ad2675f2000072834c5\"\n }\n ],\n \"existence_level\": \"full\",\n \"label_ids\": [\n \"6466e8261e13be000133f25d\"\n ],\n \"typed_custom_fields\": {},\n \"custom_field_errors\": null,\n \"modality\": \"account\",\n \"source_display_name\": \"Uploaded from CSV\",\n \"crm_record_url\": null,\n \"contact_emailer_campaign_ids\": [],\n \"contact_campaign_status_tally\": {},\n \"num_contacts\": 0,\n \"last_activity_date\": null\n }\n }\n },\n {\n \"emailer_campaign_id\": \"66e9a1d3ad32ac02d20bd289\",\n \"id\": \"66e9a57d6bfaef01b3e3e84d\",\n \"user_id\": \"66302798d03b9601c7934ebc\",\n \"created_at\": \"2024-09-17T15:51:25.594Z\",\n \"completed_at\": null,\n \"note\": \"\",\n \"skipped_at\": null,\n \"due_at\": \"2024-09-20T13:05:00.000+00:00\",\n \"type\": \"linkedin_step_connect\",\n \"priority\": \"medium\",\n \"status\": \"scheduled\",\n \"answered\": null,\n \"contact_id\": \"66e9a56c6bfaef01b3e3e807\",\n \"person_id\": null,\n \"account_id\": \"664f9e8485c11b000127fd80\",\n \"organization_id\": null,\n \"persona_ids\": [],\n \"subject\": null,\n \"created_from\": \"zp_ui\",\n \"salesforce_type\": null,\n \"playbook_step_ids\": [],\n \"playbook_id\": null,\n \"needs_playbook_autoprospecting\": null,\n \"starred_by_user_ids\": [],\n \"salesforce_id\": null,\n \"hubspot_id\": null,\n \"opportunity_id\": null,\n \"title\": null,\n \"rule_config_id\": null,\n \"creator_id\": null,\n \"account\": {\n \"id\": \"664f9e8485c11b000127fd80\",\n \"domain\": \"rewardsnetwork.com\",\n \"name\": \"Rewards Network\",\n \"team_id\": \"6095a710bd01d100a506d4ac\",\n \"organization_id\": \"54a1b496746869401269c209\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"source\": \"deployment\",\n \"original_source\": \"crm\",\n \"creator_id\": null,\n \"owner_id\": null,\n \"created_at\": \"2024-05-23T19:52:36.137Z\",\n \"phone\": null,\n \"phone_status\": \"no_status\",\n \"hubspot_id\": null,\n \"salesforce_id\": null,\n \"crm_owner_id\": null,\n \"parent_account_id\": null,\n \"linkedin_url\": \"http://www.linkedin.com/company/rewards-network\",\n \"account_playbook_statuses\": [],\n \"account_rule_config_statuses\": [],\n \"existence_level\": \"full\",\n \"label_ids\": [],\n \"typed_custom_fields\": {},\n \"custom_field_errors\": null,\n \"modality\": \"account\",\n \"source_display_name\": \"Requested from Apollo\",\n \"crm_record_url\": null,\n \"show_intent\": false,\n \"has_intent_signal_account\": false,\n \"intent_signal_account\": null,\n \"account_queues\": []\n },\n \"contact\": {\n \"contact_roles\": [],\n \"id\": \"66e9a56c6bfaef01b3e3e807\",\n \"first_name\": \"Trevor\",\n \"last_name\": \"Beckett\",\n \"name\": \"Trevor Beckett\",\n \"linkedin_url\": \"http://www.linkedin.com/in/trevor-beckett-8d3f1a6c\",\n \"title\": \"SVP & CFO\",\n \"contact_stage_id\": \"6095a710bd01d100a506d4ae\",\n \"owner_id\": \"66302798d03b9601c7934ebc\",\n \"creator_id\": \"66302798d03b9601c7934ebc\",\n \"person_id\": \"610766bf75b2b20001a70a58\",\n \"email_needs_tickling\": false,\n \"organization_name\": \"Rewards Network\",\n \"source\": \"search\",\n \"original_source\": \"search\",\n \"organization_id\": \"54a1b496746869401269c209\",\n \"headline\": \"CFO, Private Equity\",\n \"photo_url\": null,\n \"present_raw_address\": \"Greater Chicago Area\",\n \"linkedin_uid\": null,\n \"extrapolated_email_confidence\": null,\n \"salesforce_id\": null,\n \"salesforce_lead_id\": null,\n \"salesforce_contact_id\": null,\n \"salesforce_account_id\": null,\n \"crm_owner_id\": null,\n \"created_at\": \"2024-09-17T15:51:08.545Z\",\n \"emailer_campaign_ids\": [\n \"66e9a1d3ad32ac02d20bd289\"\n ],\n \"direct_dial_status\": null,\n \"direct_dial_enrichment_failed_at\": null,\n \"email_status\": \"verified\",\n \"email_source\": \"emailer_message_outbound\",\n \"account_id\": \"664f9e8485c11b000127fd80\",\n \"last_activity_date\": null,\n \"hubspot_vid\": null,\n \"hubspot_company_id\": null,\n \"crm_id\": null,\n \"sanitized_phone\": \"+18665550159\",\n \"merged_crm_ids\": null,\n \"updated_at\": \"2024-09-17T15:51:25.590Z\",\n \"queued_for_crm_push\": null,\n \"suggested_from_rule_engine_config_id\": null,\n \"email_unsubscribed\": null,\n \"label_ids\": [],\n \"has_pending_email_arcgate_request\": false,\n \"has_email_arcgate_request\": false,\n \"existence_level\": \"full\",\n \"email\": \"trevorbeckett@example.com\",\n \"email_from_customer\": null,\n \"typed_custom_fields\": {},\n \"custom_field_errors\": null,\n \"crm_record_url\": null,\n \"email_status_unavailable_reason\": null,\n \"email_true_status\": \"Verified\",\n \"updated_email_true_status\": true,\n \"contact_rule_config_statuses\": [],\n \"source_display_name\": \"Requested from Apollo\",\n \"twitter_url\": null,\n \"contact_emails\": [],\n \"employment_history\": [\n {\n \"_id\": \"66e73c43a10f5500019f06bc\",\n \"created_at\": null,\n \"current\": true,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": null,\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"54a1b496746869401269c209\",\n \"organization_name\": \"Rewards Network\",\n \"raw_address\": null,\n \"start_date\": \"2019-09-01\",\n \"title\": \"SVP & CFO\",\n \"updated_at\": null,\n \"id\": \"66e73c43a10f5500019f06bc\",\n \"key\": \"66e73c43a10f5500019f06bc\"\n },\n {\n \"_id\": \"66e73c43a10f5500019f06bd\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2019-03-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"5b147886a6da9870e387e5d7\",\n \"organization_name\": \"VaaS International Holdings, Inc.\",\n \"raw_address\": null,\n \"start_date\": \"2017-03-01\",\n \"title\": \"SVP & CFO\",\n \"updated_at\": null,\n \"id\": \"66e73c43a10f5500019f06bd\",\n \"key\": \"66e73c43a10f5500019f06bd\"\n },\n {\n \"_id\": \"66e73c43a10f5500019f06be\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2016-05-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"56e60617f3e5bb6b7a000168\",\n \"organization_name\": \"Broadwind Energy\",\n \"raw_address\": null,\n \"start_date\": \"2013-04-01\",\n \"title\": \"President, Brad Foote Gearing\",\n \"updated_at\": null,\n \"id\": \"66e73c43a10f5500019f06be\",\n \"key\": \"66e73c43a10f5500019f06be\"\n },\n {\n \"_id\": \"66e73c43a10f5500019f06bf\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2013-04-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"54a1d25174686949e780fb13\",\n \"organization_name\": \"Pettibone LLC\",\n \"raw_address\": null,\n \"start_date\": \"2012-06-01\",\n \"title\": \"Chief Financial Officer\",\n \"updated_at\": null,\n \"id\": \"66e73c43a10f5500019f06bf\",\n \"key\": \"66e73c43a10f5500019f06bf\"\n },\n {\n \"_id\": \"66e73c43a10f5500019f06c0\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2012-06-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"56e60617f3e5bb6b7a000168\",\n \"organization_name\": \"Broadwind Energy\",\n \"raw_address\": null,\n \"start_date\": \"2011-08-01\",\n \"title\": \"Vice President Finance\",\n \"updated_at\": null,\n \"id\": \"66e73c43a10f5500019f06c0\",\n \"key\": \"66e73c43a10f5500019f06c0\"\n },\n {\n \"_id\": \"66e73c43a10f5500019f06c1\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2011-06-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"54a129dc69702d954882c501\",\n \"organization_name\": \"Federal Signal Corporation\",\n \"raw_address\": null,\n \"start_date\": \"2010-03-01\",\n \"title\": \"President, Safety and Security Systems Group\",\n \"updated_at\": null,\n \"id\": \"66e73c43a10f5500019f06c1\",\n \"key\": \"66e73c43a10f5500019f06c1\"\n },\n {\n \"_id\": \"66e73c43a10f5500019f06c2\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2010-07-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"54a129dc69702d954882c501\",\n \"organization_name\": \"Federal Signal Corporation\",\n \"raw_address\": null,\n \"start_date\": \"2008-08-01\",\n \"title\": \"Vice President & Corporate Controller\",\n \"updated_at\": null,\n \"id\": \"66e73c43a10f5500019f06c2\",\n \"key\": \"66e73c43a10f5500019f06c2\"\n },\n {\n \"_id\": \"66e73c43a10f5500019f06c3\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2008-08-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"54a129dc69702d954882c501\",\n \"organization_name\": \"Federal Signal Corporation\",\n \"raw_address\": null,\n \"start_date\": \"2006-09-01\",\n \"title\": \"Vice President & Treasurer\",\n \"updated_at\": null,\n \"id\": \"66e73c43a10f5500019f06c3\",\n \"key\": \"66e73c43a10f5500019f06c3\"\n },\n {\n \"_id\": \"66e73c43a10f5500019f06c4\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2006-08-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"54a129dc69702d954882c501\",\n \"organization_name\": \"Federal Signal Corporation\",\n \"raw_address\": null,\n \"start_date\": \"2002-06-01\",\n \"title\": \"Vice President, Finance -- Safety Products Group\",\n \"updated_at\": null,\n \"id\": \"66e73c43a10f5500019f06c4\",\n \"key\": \"66e73c43a10f5500019f06c4\"\n },\n {\n \"_id\": \"66e73c43a10f5500019f06c5\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2002-06-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": null,\n \"organization_name\": \"Zellweger Analytics, Inc.\",\n \"raw_address\": null,\n \"start_date\": \"2001-05-01\",\n \"title\": \"Vice President, Finance & Administration, Secretary & Treasurer\",\n \"updated_at\": null,\n \"id\": \"66e73c43a10f5500019f06c5\",\n \"key\": \"66e73c43a10f5500019f06c5\"\n },\n {\n \"_id\": \"66e73c43a10f5500019f06c6\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2001-01-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": null,\n \"organization_name\": \"Woodhead Industries, Inc.\",\n \"raw_address\": null,\n \"start_date\": \"1995-01-01\",\n \"title\": \"Controller\",\n \"updated_at\": null,\n \"id\": \"66e73c43a10f5500019f06c6\",\n \"key\": \"66e73c43a10f5500019f06c6\"\n },\n {\n \"_id\": \"66e73c43a10f5500019f06c7\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"1987-01-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"54a1233869702d8ed4ee5703\",\n \"organization_name\": \"Deloitte\",\n \"raw_address\": null,\n \"start_date\": \"1985-01-01\",\n \"title\": \"Senior Accountant\",\n \"updated_at\": null,\n \"id\": \"66e73c43a10f5500019f06c7\",\n \"key\": \"66e73c43a10f5500019f06c7\"\n }\n ],\n \"time_zone\": \"America/Chicago\",\n \"show_intent\": false,\n \"phone_numbers\": [\n {\n \"raw_number\": \"+1 866-555-0159\",\n \"sanitized_number\": \"+18665550159\",\n \"type\": \"work_hq\",\n \"position\": 0,\n \"status\": \"no_status\",\n \"dnc_status\": null,\n \"dnc_other_info\": null,\n \"dialer_flags\": null\n }\n ],\n \"account_phone_note\": null,\n \"free_domain\": false,\n \"is_likely_to_engage\": true,\n \"email_domain_catchall\": true\n },\n \"campaign_name\": \"1A VIP Executives Chicago Area Sales Team 100 !!\",\n \"campaign_position\": 1,\n \"linkedin_emailer_template\": {\n \"id\": \"66e9a4846bfaef02d2e3cd88\",\n \"body_text\": \"\"\n }\n },\n {\n \"emailer_campaign_id\": \"66e9a1d3ad32ac02d20bd289\",\n \"id\": \"66e9a57d6bfaef01b3e3e84e\",\n \"user_id\": \"66302798d03b9601c7934ebc\",\n \"created_at\": \"2024-09-17T15:51:25.594Z\",\n \"completed_at\": null,\n \"note\": \"\",\n \"skipped_at\": null,\n \"due_at\": \"2024-09-20T13:04:00.000+00:00\",\n \"type\": \"linkedin_step_connect\",\n \"priority\": \"medium\",\n \"status\": \"scheduled\",\n \"answered\": null,\n \"contact_id\": \"66e9a56c6bfaef01b3e3e805\",\n \"person_id\": null,\n \"account_id\": \"66e9a56c6bfaef01b3e3e809\",\n \"organization_id\": null,\n \"persona_ids\": [],\n \"subject\": null,\n \"created_from\": \"zp_ui\",\n \"salesforce_type\": null,\n \"playbook_step_ids\": [],\n \"playbook_id\": null,\n \"needs_playbook_autoprospecting\": null,\n \"starred_by_user_ids\": [],\n \"salesforce_id\": null,\n \"hubspot_id\": null,\n \"opportunity_id\": null,\n \"title\": null,\n \"rule_config_id\": null,\n \"creator_id\": null,\n \"account\": {\n \"id\": \"66e9a56c6bfaef01b3e3e809\",\n \"domain\": \"radwell.com\",\n \"name\": \"Radwell International\",\n \"team_id\": \"6095a710bd01d100a506d4ac\",\n \"organization_id\": \"5569da7a73696425e291a500\",\n \"account_stage_id\": \"6095a710bd01d100a506d4b7\",\n \"source\": \"deployment\",\n \"original_source\": \"deployment\",\n \"creator_id\": \"66302798d03b9601c7934ebc\",\n \"owner_id\": \"66302798d03b9601c7934ebc\",\n \"created_at\": \"2024-09-17T15:51:08.585Z\",\n \"phone\": \"+1 800-555-0185\",\n \"phone_status\": \"no_status\",\n \"hubspot_id\": null,\n \"salesforce_id\": null,\n \"crm_owner_id\": null,\n \"parent_account_id\": null,\n \"linkedin_url\": \"http://www.linkedin.com/company/radwell-international\",\n \"sanitized_phone\": \"+18005550185\",\n \"account_playbook_statuses\": [],\n \"account_rule_config_statuses\": [],\n \"existence_level\": \"full\",\n \"label_ids\": [],\n \"typed_custom_fields\": {},\n \"custom_field_errors\": null,\n \"modality\": \"account\",\n \"source_display_name\": \"Requested from Apollo\",\n \"crm_record_url\": null,\n \"show_intent\": false,\n \"has_intent_signal_account\": false,\n \"intent_signal_account\": null,\n \"account_queues\": []\n },\n \"contact\": {\n \"contact_roles\": [],\n \"id\": \"66e9a56c6bfaef01b3e3e805\",\n \"first_name\": \"Henry\",\n \"last_name\": \"Castellano\",\n \"name\": \"Henry Castellano\",\n \"linkedin_url\": \"http://www.linkedin.com/in/henry-castellano-4b7e2d95\",\n \"title\": \"Chief Financial Officer\",\n \"contact_stage_id\": \"6095a710bd01d100a506d4ae\",\n \"owner_id\": \"66302798d03b9601c7934ebc\",\n \"creator_id\": \"66302798d03b9601c7934ebc\",\n \"person_id\": \"5cbfca3c80f93e7bc122b5a4\",\n \"email_needs_tickling\": false,\n \"organization_name\": \"Radwell International\",\n \"source\": \"search\",\n \"original_source\": \"search\",\n \"organization_id\": \"5569da7a73696425e291a500\",\n \"headline\": \"CFO\",\n \"photo_url\": null,\n \"present_raw_address\": \"Chicago, Illinois, United States\",\n \"linkedin_uid\": \"73920514\",\n \"extrapolated_email_confidence\": null,\n \"salesforce_id\": null,\n \"salesforce_lead_id\": null,\n \"salesforce_contact_id\": null,\n \"salesforce_account_id\": null,\n \"crm_owner_id\": null,\n \"created_at\": \"2024-09-17T15:51:08.545Z\",\n \"emailer_campaign_ids\": [\n \"66e9a1d3ad32ac02d20bd289\"\n ],\n \"direct_dial_status\": null,\n \"direct_dial_enrichment_failed_at\": null,\n \"email_status\": \"verified\",\n \"email_source\": \"crm_csv\",\n \"account_id\": \"66e9a56c6bfaef01b3e3e809\",\n \"last_activity_date\": null,\n \"hubspot_vid\": null,\n \"hubspot_company_id\": null,\n \"crm_id\": null,\n \"sanitized_phone\": \"+18005550185\",\n \"merged_crm_ids\": null,\n \"updated_at\": \"2024-09-17T15:55:35.475Z\",\n \"queued_for_crm_push\": null,\n \"suggested_from_rule_engine_config_id\": null,\n \"email_unsubscribed\": null,\n \"label_ids\": [],\n \"has_pending_email_arcgate_request\": false,\n \"has_email_arcgate_request\": false,\n \"existence_level\": \"full\",\n \"email\": \"hcastellano@example.com\",\n \"email_from_customer\": null,\n \"typed_custom_fields\": {},\n \"custom_field_errors\": null,\n \"crm_record_url\": null,\n \"email_status_unavailable_reason\": null,\n \"email_true_status\": \"Verified\",\n \"updated_email_true_status\": true,\n \"contact_rule_config_statuses\": [],\n \"source_display_name\": \"Requested from Apollo\",\n \"twitter_url\": null,\n \"contact_emails\": [\n {\n \"email\": \"henry.castellano@gmail.com\",\n \"email_md5\": \"52f8c287b9696d6d8c96149ae1529f36\",\n \"email_sha256\": \"37d698a79304f2a0cb3679e9e391b59c24cae4ca9910ced6e809eb3979ec0270\",\n \"email_status\": \"verified\",\n \"email_source\": \"rampedup\",\n \"extrapolated_email_confidence\": null,\n \"position\": 1,\n \"email_from_customer\": null,\n \"free_domain\": true\n }\n ],\n \"employment_history\": [\n {\n \"_id\": \"66d89c837898880001918444\",\n \"created_at\": null,\n \"current\": true,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": null,\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"5569da7a73696425e291a500\",\n \"organization_name\": \"Radwell International\",\n \"raw_address\": null,\n \"start_date\": \"2024-08-01\",\n \"title\": \"Chief Financial Officer\",\n \"updated_at\": null,\n \"id\": \"66d89c837898880001918444\",\n \"key\": \"66d89c837898880001918444\"\n },\n {\n \"_id\": \"66d89c837898880001918445\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2024-08-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"55ed663df3e5bb3871001966\",\n \"organization_name\": \"Optimas Solutions\",\n \"raw_address\": null,\n \"start_date\": \"2023-03-01\",\n \"title\": \"CFO\",\n \"updated_at\": null,\n \"id\": \"66d89c837898880001918445\",\n \"key\": \"66d89c837898880001918445\"\n },\n {\n \"_id\": \"66d89c837898880001918446\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2023-03-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"5e699a8d1d525e00980b32e4\",\n \"organization_name\": \"Caterpillar Inc.\",\n \"raw_address\": null,\n \"start_date\": \"2022-03-01\",\n \"title\": \"Vice President, Corporate FP&A\",\n \"updated_at\": null,\n \"id\": \"66d89c837898880001918446\",\n \"key\": \"66d89c837898880001918446\"\n },\n {\n \"_id\": \"66d89c837898880001918447\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2022-03-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"5e699a8d1d525e00980b32e4\",\n \"organization_name\": \"Caterpillar Inc.\",\n \"raw_address\": null,\n \"start_date\": \"2018-04-01\",\n \"title\": \"CFO & VP, Product Support & Logistics Division\",\n \"updated_at\": null,\n \"id\": \"66d89c837898880001918447\",\n \"key\": \"66d89c837898880001918447\"\n },\n {\n \"_id\": \"66d89c837898880001918448\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2018-04-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"5e699a8d1d525e00980b32e4\",\n \"organization_name\": \"Caterpillar Inc.\",\n \"raw_address\": null,\n \"start_date\": \"2017-01-01\",\n \"title\": \"Assistant Treasurer, Corporate Treasury\",\n \"updated_at\": null,\n \"id\": \"66d89c837898880001918448\",\n \"key\": \"66d89c837898880001918448\"\n },\n {\n \"_id\": \"66d89c837898880001918449\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2012-01-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"5592234f7369641739ce2f00\",\n \"organization_name\": \"Citi\",\n \"raw_address\": null,\n \"start_date\": \"2009-01-01\",\n \"title\": \"Director, Global Metals & Mining\",\n \"updated_at\": null,\n \"id\": \"66d89c837898880001918449\",\n \"key\": \"66d89c837898880001918449\"\n },\n {\n \"_id\": \"66d89c83789888000191844a\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2008-12-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"5592234f7369641739ce2f00\",\n \"organization_name\": \"Citi\",\n \"raw_address\": null,\n \"start_date\": \"2006-01-01\",\n \"title\": \"Vice President, Global Metals & Mining\",\n \"updated_at\": null,\n \"id\": \"66d89c83789888000191844a\",\n \"key\": \"66d89c83789888000191844a\"\n },\n {\n \"_id\": \"66d89c83789888000191844b\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2005-12-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"5592234f7369641739ce2f00\",\n \"organization_name\": \"Citi\",\n \"raw_address\": null,\n \"start_date\": \"2002-08-01\",\n \"title\": \"Associate, Generalist\",\n \"updated_at\": null,\n \"id\": \"66d89c83789888000191844b\",\n \"key\": \"66d89c83789888000191844b\"\n },\n {\n \"_id\": \"66d89c83789888000191844c\",\n \"created_at\": null,\n \"current\": false,\n \"degree\": null,\n \"description\": null,\n \"emails\": null,\n \"end_date\": \"2002-06-01\",\n \"grade_level\": null,\n \"kind\": null,\n \"major\": null,\n \"organization_id\": \"5592234f7369641739ce2f00\",\n \"organization_name\": \"Citi\",\n \"raw_address\": null,\n \"start_date\": \"1999-07-01\",\n \"title\": \"Analyst, Global Consumer Group\",\n \"updated_at\": null,\n \"id\": \"66d89c83789888000191844c\",\n \"key\": \"66d89c83789888000191844c\"\n }\n ],\n \"time_zone\": \"America/Chicago\",\n \"show_intent\": false,\n \"phone_numbers\": [\n {\n \"raw_number\": \"+1 800-555-0185\",\n \"sanitized_number\": \"+18005550185\",\n \"type\": \"work_hq\",\n \"position\": 0,\n \"status\": \"no_status\",\n \"dnc_status\": null,\n \"dnc_other_info\": null,\n \"dialer_flags\": null\n }\n ],\n \"account_phone_note\": null,\n \"free_domain\": false,\n \"is_likely_to_engage\": true,\n \"email_domain_catchall\": true\n },\n \"campaign_name\": \"1A VIP Executives Chicago Area Sales Team 100 !!\",\n \"campaign_position\": 1,\n \"linkedin_emailer_template\": {\n \"id\": \"66e9a4846bfaef02d2e3cd88\",\n \"body_text\": \"\"\n }\n }\n ],\n \"breadcrumbs\": [],\n \"pagination\": {\n \"page\": 1,\n \"per_page\": 3,\n \"total_entries\": 179,\n \"total_pages\": 60\n },\n \"faceting\": {\n \"playbook_step_facets\": [],\n \"person_function_facets\": [],\n \"person_seniority_facets\": [],\n \"normalized_person_title_facets\": [],\n \"organization_ids_facets\": [],\n \"organization_ids_in_query_facets\": [],\n \"person_persona_facets\": [],\n \"organization_keywords_facets\": [],\n \"linkedin_industry_facets\": [],\n \"num_employees_facets\": [],\n \"revenues_facets\": [],\n \"currently_using_any_of_technology_uids_facets\": [],\n \"currently_using_all_of_technology_uids_facets\": [],\n \"currently_not_using_any_of_technology_uids_facets\": [],\n \"added_technology_uids_facets\": [],\n \"dropped_technology_uids_facets\": [],\n \"latest_funding_stage_facets\": [],\n \"organization_trading_status_facets\": [],\n \"person_city_facets\": [],\n \"person_state_facets\": [],\n \"person_country_facets\": [],\n \"organization_hq_city_facets\": [],\n \"organization_hq_state_facets\": [],\n \"organization_hq_country_facets\": [],\n \"organization_intent_scoring_facets\": [],\n \"forecast_category_facets\": [],\n \"intent_topic_count_facets\": [],\n \"task_types\": [\n {\n \"value\": \"contact_call\",\n \"display_name\": \"Call Contact\",\n \"count\": 30\n },\n {\n \"value\": \"outreach_manual_email\",\n \"display_name\": \"Email Contact\",\n \"count\": 23\n },\n {\n \"value\": \"contact_action_item\",\n \"display_name\": \"Contact Action Item\",\n \"count\": 53\n },\n {\n \"value\": \"account_action_item\",\n \"display_name\": \"Account Action Item\",\n \"count\": 16\n },\n {\n \"value\": \"account_add_people_action\",\n \"display_name\": \"Add People on Account\",\n \"count\": 31\n },\n {\n \"value\": \"linkedin_actions\",\n \"display_name\": \"Linkedin Actions\",\n \"count\": 26\n },\n {\n \"value\": \"linkedin_step_connect\",\n \"display_name\": \"LI: Send connection request\",\n \"count\": 26\n }\n ],\n \"total_facets\": [\n {\n \"value\": \"pipeline_total\",\n \"display_name\": \"Total\",\n \"count\": 179\n }\n ],\n \"linkedin_task\": [],\n \"contact_stage_facets\": []\n },\n \"pipeline_total\": 179,\n \"num_fetch_result\": null\n}",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "071131b8-6875-45a4-b7ab-26a8c373f04e",
"name": "401",
"originalRequest": {
"url": {
"path": [
"tasks",
"search"
],
"host": [
"{{baseUrl}}"
],
"query": [
{
"key": "sort_by_field",
"value": ""
},
{
"key": "open_factor_names[]",
"value": ""
},
{
"key": "open_factor_names[]",
"value": ""
},
{
"key": "page",
"value": ""
},
{
"key": "per_page",
"value": ""
}
],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "text/plain"
}
],
"method": "POST",
"body": {}
},
"status": "Unauthorized",
"code": 401,
"header": [
{
"key": "Content-Type",
"value": "text/plain"
}
],
"body": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate.",
"cookie": [],
"_postman_previewlanguage": "text"
},
{
"id": "5a8e8468-3f82-4d99-8cc3-738b6973a767",
"name": "403",
"originalRequest": {
"url": {
"path": [
"tasks",
"search"
],
"host": [
"{{baseUrl}}"
],
"query": [
{
"key": "sort_by_field",
"value": ""
},
{
"key": "open_factor_names[]",
"value": ""
},
{
"key": "open_factor_names[]",
"value": ""
},
{
"key": "page",
"value": ""
},
{
"key": "per_page",
"value": ""
}
],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {}
},
"status": "Forbidden",
"code": 403,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"This API key is not authorized to access api/v1/tasks/search. Request an API key from your administrator that includes this endpoint in its configured scope.\\\",\\n \\\"error_code\\\": \\\"API_INACCESSIBLE\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "5f6689c9-6f64-4410-b809-cbdddb8f98ae",
"name": "422",
"originalRequest": {
"url": {
"path": [
"tasks",
"search"
],
"host": [
"{{baseUrl}}"
],
"query": [
{
"key": "sort_by_field",
"value": ""
},
{
"key": "open_factor_names[]",
"value": ""
},
{
"key": "open_factor_names[]",
"value": ""
},
{
"key": "page",
"value": ""
},
{
"key": "per_page",
"value": ""
}
],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {}
},
"status": "Unprocessable Entity (WebDAV) (RFC 4918)",
"code": 422,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"error\\\": \\\"Something's wrong with your API request. undefined method `[]' for nil\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
},
{
"id": "7d83bbad-21e1-4c79-a130-16fec89f18a1",
"name": "429",
"originalRequest": {
"url": {
"path": [
"tasks",
"search"
],
"host": [
"{{baseUrl}}"
],
"query": [
{
"key": "sort_by_field",
"value": ""
},
{
"key": "open_factor_names[]",
"value": ""
},
{
"key": "open_factor_names[]",
"value": ""
},
{
"key": "page",
"value": ""
},
{
"key": "per_page",
"value": ""
}
],
"variable": []
},
"header": [
{
"description": {
"content": "Added as a part of security scheme: apikey",
"type": "text/plain"
},
"key": "x-api-key",
"value": ""
},
{
"key": "Accept",
"value": "application/json"
}
],
"method": "POST",
"body": {}
},
"status": "Too Many Requests",
"code": 429,
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"{\\n \\\"message\\\": \\\"The maximum number of api calls allowed for api/v1/tasks/search is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\\\"\\n}\"",
"cookie": [],
"_postman_previewlanguage": "json"
}
],
"event": [],
"protocolProfileBehavior": {
"disableBodyPruning": true
}
}
],
"event": []
}
],
"event": [],
"variable": [
{
"type": "string",
"value": "https://api.apollo.io/api/v1",
"key": "baseUrl"
}
],
"auth": {
"type": "apikey",
"apikey": [
{
"key": "key",
"value": "x-api-key"
},
{
"key": "value",
"value": "{{apiKey}}"
},
{
"key": "in",
"value": "header"
}
]
},
"info": {
"_postman_id": "b10c992b-4fc9-4fed-bbaa-769a9b61665b",
"name": "Apollo API — Tasks",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
"description": {
"content": "The Apollo API provides programmatic access to [Apollo](https://www.apollo.io/), the all-in-one sales intelligence and engagement platform. Use it to enrich people and company data (individually or in bulk), search Apollo's database of over 240 million contacts and 30 million companies, and manage accounts, contacts, deals, sequences, tasks, calls, and conversations in your go-to-market workflows.\n\n## Base URL\n\nAll API requests are made to `https://api.apollo.io/api/v1`.\n\n## Authentication\n\n- **Apollo users** authenticate with an API key passed in the `x-api-key` request header. See [Create API Keys](https://docs.apollo.io/docs/create-api-key).\n- **Apollo partners** building integrations on behalf of mutual users authenticate with the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners).\n\n## Rate limits & credits\n\nRate limits and credit consumption depend on your [Apollo pricing plan](https://docs.apollo.io/docs/api-pricing). Check your current limits and usage with the [View API Usage Stats and Rate Limits](https://docs.apollo.io/reference/view-api-usage-stats) endpoint. For more details, see [Rate Limits](https://docs.apollo.io/reference/rate-limits) and the [API FAQs](https://docs.apollo.io/docs/apollo-api-faqs).\n\nNew to the API? Start with the [Apollo API overview](https://docs.apollo.io/reference/apollo-api).\n\nContact Support:\n Name: Apollo API Support",
"type": "text/plain"
}
}
}