# Act-On Documentation > Documentation for Act-On ## API Reference: ACT-ON API - [API Overview](https://developer.act-on.com/reference/api-overview.md) - [Request a Developer Account](https://developer.act-on.com/reference/request-a-developer-account.md) - Account - [Userspecs Overview](https://developer.act-on.com/reference/userspecs-overview.md): Userspecs is a JSON object to describe the users that are to be created. You pass the userspecs as a form parameter. The userspecs can contain any number of users to create. However, the each account… - [Create new account user](https://developer.act-on.com/reference/create-new-account-user.md): Create one or more users for an account. - [Delete account users](https://developer.act-on.com/reference/delete-account-users.md): Delete one or more users from an account. - [Get defined email senders](https://developer.act-on.com/reference/get-defined-email-senders.md): Retrieve the list of email senders (from-name / from-address / reply-to pairs) that have been defined for the account. These are the identities available to choose from when creating or sending a… - Fact - [Upload custom events](https://developer.act-on.com/reference/upload-custom-events.md): Upload a batch of custom events for your contacts via a simple multipart file POST to the Fact API. Custom events let you record account-specific activity data (e.g. product usage, purchases, support… - [Get upload custom event status](https://developer.act-on.com/reference/get-upload-custom-event-status.md): Get the status of a custom event upload a simple HTTP GET to the Fact & Reporting API - Content - [Get logo list](https://developer.act-on.com/reference/get-logo-list.md): Retrieve the list of logo image assets stored in the account's Content Library, along with each logo's ID for use with Get a logo, Update a logo, and Delete a logo. - [Add a logo](https://developer.act-on.com/reference/add-a-logo.md): Add a new logo to your account's Content Library, either by uploading a file or by referencing an externally hosted image URL. The logo becomes available for use in headers, footers, and messages,… - [Get a logo](https://developer.act-on.com/reference/get-a-logo.md): Retrieve a single logo image asset by its ID from your account's Content Library. Use Get logo list first if you need to find the ID of the logo you want. - [Update a logo](https://developer.act-on.com/reference/update-a-logo.md): Update an existing logo's file, URL, or metadata by its ID. Use Get logo list to find the logo's ID first. - [Delete a logo](https://developer.act-on.com/reference/delete-a-logo.md): Permanently delete a logo from your account's Content Library by its ID. Use Get logo list to find the ID first. - [Get header list](https://developer.act-on.com/reference/get-header-list.md): Retrieve the list of email header blocks defined in the account, along with each header's ID for use with Get a header, Update a header, and Delete a header. - [Get a header](https://developer.act-on.com/reference/get-a-header.md): Retrieve a single email header block by its ID. Headers are reusable branding/content snippets (e.g. a logo bar or preheader) that can be attached to the top of email messages. Use Get header list… - [Update a header](https://developer.act-on.com/reference/update-a-header.md): Update the content of an existing email header block by its ID. Use Get header list to find the ID first. - [Delete a header](https://developer.act-on.com/reference/delete-a-header.md): Permanently delete an email header block from your account by its ID. Use Get header list to find the ID first. - [Add a header](https://developer.act-on.com/reference/add-a-header.md): Create a new reusable email header block in your account, available for use at the top of email messages. - [Get footer list](https://developer.act-on.com/reference/get-footer-list.md): Retrieve the list of footer blocks defined in the account, along with each footer's ID for use with Get a footer, Update a footer, and Delete a footer. Footers typically contain the CAN-SPAM-required… - [Get a footer](https://developer.act-on.com/reference/get-a-footer.md): Get the specified footer by ID. Act-On assigns integer IDs to footers in numerical order when added, starting with the default footer with ID of 0 at account initiation. - [Delete a footer](https://developer.act-on.com/reference/delete-a-footer.md): Permanently delete an existing footer from the account by its ID. Use Get footer list to find the ID first. - [Update a footer](https://developer.act-on.com/reference/update-a-footer.md): Update the content of an existing footer by its ID. Use Get footer list to find the ID first; note that the default footer created at account setup has ID 0. - [Add a new footer](https://developer.act-on.com/reference/add-a-new-footer.md): Add a new footer to your account. To view default formatting for footers, use Get footer list — the default footer (ID 0) contains standard elements you may want to reuse when creating a new one.… - [Get image list](https://developer.act-on.com/reference/get-image-list.md): Retrieve the list of images stored in the account's Content Library, along with each image's ID for use with Get an image, Update an image, and Delete an image. - [Add an image](https://developer.act-on.com/reference/add-an-image.md): Add a new image to your account's Content Library, available afterward for use in headers, footers, landing pages, and messages. Note: this is a multipart/form-data POST. - [Get an image](https://developer.act-on.com/reference/get-an-image.md): Retrieve a single image asset by its ID from the account's Content Library. Use Get image list first to find the image's ID. - [Update an image](https://developer.act-on.com/reference/update-an-image.md): Replace an existing image in the Content Library by its ID, keeping the same ID so existing references to it (in headers, footers, landing pages, messages) continue to point at the new file. - [Delete an image](https://developer.act-on.com/reference/delete-an-image.md): Permanently delete an image from the account's Content Library by its ID. Use Get image list to find the image's ID first. - [Get media list](https://developer.act-on.com/reference/get-media-list.md): Retrieve a listing of media objects (gated content such as PDFs, whitepapers, or other downloadable/trackable files) stored in your account, along with each media object's ID for use with Get media… - [Get media file](https://developer.act-on.com/reference/get-media-file.md): Retrieve the download path for a media object by its ID (the response is a URL/path, not the raw file bytes). Use Get media list to find the ID first. - [Update Media File](https://developer.act-on.com/reference/update-media-file.md): Replace an existing media object's file by its ID. Use Get media list to find the ID first. - [Delete a media object](https://developer.act-on.com/reference/delete-a-media-object.md): Permanently delete a media object (uploaded file or media link) from your account by its ID. Use Get media list to find the ID first. - [Add a media file](https://developer.act-on.com/reference/add-a-media-file.md): Add a new media file (e.g. a PDF or other downloadable document) to your account as a trackable media object. Once added, its views and downloads can be reported on with the media reporting… - [Add a media link](https://developer.act-on.com/reference/add-a-media-link.md): Add an externally hosted URL as a trackable media link in your account, so its clicks can be tracked the same way as an uploaded media file, without needing to host the file in Act-On. Note: this is… - [Get form list](https://developer.act-on.com/reference/get-form-list.md): Retrieve the list of forms in your account's Forms repository, along with each form's ID for use with Get classic form URLs and Get form report. Forms themselves are created and edited in the Act-On… - [Get classic form URLs](https://developer.act-on.com/reference/get-classic-form-urls.md): Get the promotional URLs associated with the specified form, by form ID. To get a listing of forms in an account with their associated IDs, use the Get Forms List API. - [Get landing page list](https://developer.act-on.com/reference/get-landing-page-list.md): Retrieve the list of landing pages in your account, along with each page's ID for use with Get landing page, Get landing page URLs, Delete landing page, and Get landing page report. - [Get landing page](https://developer.act-on.com/reference/get-landing-page.md): Retrieve the details of a single landing page by its ID. Use Get landing page list to find the ID first. - [Delete landing page](https://developer.act-on.com/reference/delete-landing-page.md): Permanently delete a landing page from your account by its ID. Use Get landing page list to find the ID first. - [Get landing page URLs](https://developer.act-on.com/reference/get-landing-page-urls.md): Retrieve the promotional/tracked URLs for a landing page by its ID. Use Get landing page list to find the ID first. - [Get list of programs](https://developer.act-on.com/reference/get-list-of-programs.md): Retrieve a list of programs of the specified type: automated programs (TRACK), webinars/events (EVENT), or list maintenance programs (LIST_MAINT). - Reporting - [Get message report](https://developer.act-on.com/reference/get-message-report.md): Get summary engagement counts (sent, suppressed, opened, clicked, bounced, opt-out, spam complaints) for a single email message by its ID. Use Get message report drilldown to retrieve the individual… - [Get message report drilldown](https://developer.act-on.com/reference/get-message-report-drilldown.md): Retrieve the paginated, contact-level records behind one metric from a message's report (SENT, SUPPRESSED, OPENED, CLICKED, BOUNCED, OPT_OUT, or SPAM), as specified by the drilldown parameter. Use… - [Get message report by time period](https://developer.act-on.com/reference/get-message-report-by-time-period.md): Fetch the account-wide message rollup report for a given month, aggregating engagement across all messages sent in that period rather than a single message. Specify the period in YYMM format (e.g.… - [Get media report](https://developer.act-on.com/reference/get-media-report.md): Get a summary engagement report for a media object by its ID. For more granular breakdowns, see Get a media view report, Get a media timeline report, and Get media message report. - [Get media message report](https://developer.act-on.com/reference/get-media-message-report.md): Get a report showing which email messages linked to a media object, and how many views/downloads each message drove, by the media object's ID. - [Get a media view report](https://developer.act-on.com/reference/get-a-media-view-report.md): Get the view/download counts for a media object by its ID. See also Get a media timeline report for how views trend over time, and Get media message report for which messages drove those views. - [Get a media timeline report](https://developer.act-on.com/reference/get-a-media-timeline-report.md): Get a report showing how views/downloads of a media object are distributed over time, by its ID. See also Get a media view report for the overall totals. - [Get form report](https://developer.act-on.com/reference/get-form-report.md): Get a submissions/engagement report for a form by its ID. Use Get form list first to find the form's ID. - [Get landing page report](https://developer.act-on.com/reference/get-landing-page-report.md): Get a report on the specified landing page. - Email Campaign - [Get message list](https://developer.act-on.com/reference/get-message-list.md): Retrieve a paginated listing of email messages, filtered by type (draft, template, sent, triggered, failed, or scheduled). - [Add new template or draft message](https://developer.act-on.com/reference/add-new-template-or-draft-message.md): Add a draft message or template message to your account. - [Get Campaign](https://developer.act-on.com/reference/get-campaign.md): Get the specified campaign by ID. - [Get Campaigns List](https://developer.act-on.com/reference/get-campaigns-list.md): Retrieve a listing of campaigns in your account. - [Send a message](https://developer.act-on.com/reference/send-a-message.md): Send the specified message with a simple HTTP POST to the Email Campaign API. - [Resend a message](https://developer.act-on.com/reference/resend-a-message.md): Update and resend a previously sent message using its ID. See Send a message for sending a message for the first time. - [Update template or draft message](https://developer.act-on.com/reference/update-template-or-draft-message.md): Update an existing draft message or template in your account by its ID. Use Get message list to find drafts/templates and their IDs, and Send a message once you're ready to send it. Include… - [Delete a message](https://developer.act-on.com/reference/delete-a-message.md): Permanently delete a message, template, or draft from your account by its ID. Use Get message list to find the ID first. - [Get message HTML contents](https://developer.act-on.com/reference/get-message-html-contents.md): Get the HTML content of a Sent, Draft or Message Template - [ETE Request](https://developer.act-on.com/reference/ete-request.md): Send an event-triggered (transactional) email using the specified template. Unlike Send a message, the recipient does not need to already exist as a contact or record in Act-On — supply the recipient… - SEO - [Get a new SEO report](https://developer.act-on.com/reference/get-a-new-seo-report.md): Run a fresh SEO analysis on a specific page URL, scored against the given keyword. This kicks off a new report rather than retrieving a previously generated one. - [Get SEO keywords](https://developer.act-on.com/reference/get-seo-keywords.md): Fetch the SEO keywords tracked for a specific page URL in your account. Use Get a new SEO report to run a fresh analysis for a keyword instead. - Contacts > Contact - [Add a contact](https://developer.act-on.com/reference/add-a-contact.md): Add a contact record to the specified list. - [Upsert a contact record by email](https://developer.act-on.com/reference/upsert-a-contact-record-by-email.md): Update an existing record or insert a new contact record, matched by email address. If the email exists in the list, only the first matching record is updated (duplicates are NOT updated) with the… - [Get contact history and score](https://developer.act-on.com/reference/get-contact-history-and-score.md): Get the history and lead score for the specified contact record. For how to look up a record when you only know the contact's email address (not the recID), see question #8 on our API FAQ. - [Get contact record](https://developer.act-on.com/reference/get-contact-record.md): Download a contact record from your account. For information about how to get a contact record when you do not know the record's recID and only have their email address, please review question #8 on… - [Update a contact by record ID](https://developer.act-on.com/reference/update-a-contact-by-record-id.md): Update the specified contact record in the specified list. Note: this only updates the identified record in the list you specify. - [Delete a contact](https://developer.act-on.com/reference/delete-a-contact.md): Remove a single contact record from the specified list, using the compound record ID format "{listid}:{recordid}". To delete several contacts at once, use Delete multiple contacts instead. - [Get contact record ID based on cookie value](https://developer.act-on.com/reference/get-contact-record-id-based-on-cookie-value.md): Look up the contact record ID matching an Act-On tracking cookie value, useful for resolving a website visitor's cookie into a contact record ID before calling Get contact record or other… - [Get contact from list based on cookie ID or e-mail](https://developer.act-on.com/reference/get-contact-from-list-based-on-cookie-id-or-e-mail.md): Look up a contact record within a specific list, matched by tracking cookie ID or email address — provide either one (or both). Useful for resolving an anonymous website visitor's cookie to a known… - [Set Multiple Subscriptions by email address](https://developer.act-on.com/reference/set-multiple-subscriptions-by-email-address.md): Add/remove individual records from a subscription category by email address. - [Update Subscription by Email](https://developer.act-on.com/reference/update-subscription-by-email.md): Add/remove individual records from a subscription category by email address. - Contact > Marketing Lists - [UploadSpecs Overview](https://developer.act-on.com/reference/uploadspecs-overview.md) - [Mergespecs Overview](https://developer.act-on.com/reference/mergespecs-overview.md) - [Delete records from a list](https://developer.act-on.com/reference/delete-records-from-a-list.md): Delete up to 100 contact records from the specified list in a single call, by their record IDs. Any records that fail to delete are reported back separately rather than failing the whole request. - [Get list of Act-On Assets](https://developer.act-on.com/reference/get-list-of-act-on-assets.md): Retrieve a paginated listing of Act-On assets — contact lists, headers, footers, senders, media, landing pages, or messages — filtered by the asset type specified in listingtype. - [Create a new list](https://developer.act-on.com/reference/create-a-new-list.md): Create a new contact list in your account, optionally uploading an initial file of contacts. The file's column headings become the list's own field names (see the UploadSpecs Overview guide for the… - [Download List](https://developer.act-on.com/reference/download-list.md): Download the contact records in the specified list, paginated and optionally filtered by last-modified date. - [Update or merge a list](https://developer.act-on.com/reference/update-or-merge-a-list.md): Update or Merge to an existing Act-On list. This call is asynchronous: it returns immediately with a jobId rather than waiting for the upload to finish processing. Poll Get list upload status with… - [Delete a list](https://developer.act-on.com/reference/delete-a-list.md): Permanently delete a contact list, and all the records it contains, from your account by its ID. Use Get list of Act-On Assets to find the list's ID first. - [Get list upload status](https://developer.act-on.com/reference/get-list-upload-status.md): Check the processing status of an asynchronous list upload (e.g. from Create a new list or Update or merge a list) by its jobId — pending, running, or complete. If some rows failed, use Get rejected… - [Get rejected records from an upload](https://developer.act-on.com/reference/get-rejected-records-from-an-upload.md): Download a CSV file of the records that failed to import during a list upload, so you can review and fix them. Check Get list upload status first for the filename to pass here. - Contacts > System Lists - [Get Subscription Categories](https://developer.act-on.com/reference/get-subscription-categories.md): Returns the subscription categories defined in the account. Use these category names with Set Multiple Subscriptions by email address and Get subscription opt-outs by category. - [Get subscription opt-outs by category](https://developer.act-on.com/reference/get-subscription-opt-outs-by-category.md): Download a paginated list of contacts who have opted out of a specific subscription category. The category parameter is required and must match one of the names returned by Get Subscription… - [Get hard bounce list](https://developer.act-on.com/reference/get-hard-bounce-list.md): Get a list of hard bounces associated with the account. - [Get spam complaint list](https://developer.act-on.com/reference/get-spam-complaint-list.md): Get a list of spam complaints from your account. - [Get Opt Out List](https://developer.act-on.com/reference/get-opt-out-list.md): Get a list of opt outs from your account. - [Update optout list](https://developer.act-on.com/reference/update-optout-list.md): Update or Merge to an existing optout list. - [Remove Opt Outs](https://developer.act-on.com/reference/remove-opt-outs-1.md): Remove one or more email addresses from the account's opt-out list, re-enabling delivery to them. ## API Reference: oauth - [Grant-Type Password](https://developer.act-on.com/reference/grant-type-password.md): Use Username and password to get access token and refresh token - [Grant-Type Refresh](https://developer.act-on.com/reference/grant-type-refresh.md): Uses refresh_token to get a new access_token and refresh_token - [Grant-Type Code](https://developer.act-on.com/reference/grant-type-code.md): Uses authorization code to generate access_token and refresh_token ## API Reference: Audience Center Contacts API - Contact Import Management - [Import Contacts](https://developer.act-on.com/reference/import-contacts.md): Run an import using a previously created import definition, uploading the contact file data specified by that definition. Use Create an Import Definition first to define the column mapping, then poll… - [Get Import Definitions](https://developer.act-on.com/reference/get-import-definitions.md): Retrieve all import definitions configured for this account. Each definition describes how a contact file's columns map to Act-On contact fields for use with Import Contacts. - [Create an Import Definition](https://developer.act-on.com/reference/create-an-import-definition.md): Create a new import definition, describing how a contact file's columns map to Act-On contact fields for a future import (via Import Contacts). Supports matching contacts by external ID as well as… - [Get Import Definition by Id](https://developer.act-on.com/reference/get-import-definition-by-id.md): Retrieve a single import definition by its ID, showing its full column-mapping configuration. Use Get Import Definitions to find the ID first. - [Update an Import Definition](https://developer.act-on.com/reference/update-an-import-definition.md): Update an existing import definition's column mapping by its ID. Use Get Import Definitions to find the ID first. - [Delete Import Definition by Id](https://developer.act-on.com/reference/delete-import-definition-by-id.md): Delete an existing import definition by its ID. - [Get Import status](https://developer.act-on.com/reference/get-import-status.md): Check the status of an in-progress or completed import job. - Contact Management - [Get contacts from the Act-On Contacts List](https://developer.act-on.com/reference/get-contacts-from-the-act-on-contacts-list.md): Retrieve a paginated list of contacts from the Act-On Contacts List, optionally filtered by creation date. This is the modern (Audience Center) contacts API — see Add a contact / Get contact record… - [Add a single contact to the Act-On Contacts List](https://developer.act-on.com/reference/add-a-single-contact-to-the-act-on-contacts-list.md): Add a single contact to the Act-On Contacts List. Set createContactMethod to EMAIL or EXTERNAL_ID to control which field is used to identify/deduplicate the contact. - [Get contacts from the Act-On Contacts List specifying the fields to be returned](https://developer.act-on.com/reference/get-contacts-from-the-act-on-contacts-list-specifying-the-fields-to-be-returned.md): Retrieve a paginated list of contacts, returning only the specific fields named in the request body. - [Get contact in the Act-On Contacts List by cookie id](https://developer.act-on.com/reference/get-contact-in-the-act-on-contacts-list-by-cookie-id.md): Retrieve a contact from the Act-On Contacts List by its tracking cookie ID. - [Get contacts from the Act-On Contacts List by email address](https://developer.act-on.com/reference/get-contacts-from-the-act-on-contacts-list-by-email-address.md): Retrieve contacts from the Act-On Contacts List matching the specified email address. - [Update contacts in the Act-On Contacts List by email address](https://developer.act-on.com/reference/update-contacts-in-the-act-on-contacts-list-by-email-address.md): Update a contact in the Act-On Contacts List matched by email address. - [Delete contact in the Act-On Contacts List by email address](https://developer.act-on.com/reference/delete-contact-in-the-act-on-contacts-list-by-email-address.md): Delete a contact from the Act-On Contacts List by email address. - [Delete contacts in the Act-On Contacts List by emails](https://developer.act-on.com/reference/delete-contacts-in-the-act-on-contacts-list-by-emails.md): Delete multiple contacts from the Act-On Contacts List by email address, specified in the request body. - [Get contact in the Act-On Contacts List by externalId and object type](https://developer.act-on.com/reference/get-contact-in-the-act-on-contacts-list-by-externalid-and-object-type.md): Retrieve a contact from the Act-On Contacts List by its external ID and object type. - [Update contact in the Act-On Contacts list by externalId & objectType, fallback to email match](https://developer.act-on.com/reference/update-contact-in-the-act-on-contacts-list-by-externalid-objecttype-fallback-to-email-match.md): Update a contact in the Act-On Contacts List by external ID and object type, falling back to matching by email if no external ID match is found. The request body must include `externalId` and… - [Delete contact in the Act-On Contacts List by externalId and object type](https://developer.act-on.com/reference/delete-contact-in-the-act-on-contacts-list-by-externalid-and-object-type.md): Delete a contact from the Act-On Contacts List by its external ID and object type. - [Get contact in the Act-On Contacts List by id](https://developer.act-on.com/reference/get-contact-in-the-act-on-contacts-list-by-id.md): Retrieve a contact from the Act-On Contacts List by its record ID. - [Update contact in the Act-On Contacts List by id](https://developer.act-on.com/reference/update-contact-in-the-act-on-contacts-list-by-id.md): Update a contact in the Act-On Contacts List by its record ID. - [Delete contacts in the Act-On Contacts List by ids](https://developer.act-on.com/reference/delete-contacts-in-the-act-on-contacts-list-by-ids.md): Delete multiple contacts from the Act-On Contacts List by record ID, specified in the request body. - Contact Report Management - [Get contact history by email address](https://developer.act-on.com/reference/get-contact-history-by-email-address.md): Retrieve the activity timeline history for the contact matching the specified email address. - [Get all scores for a contact by email address](https://developer.act-on.com/reference/get-all-scores-for-a-contact-by-email-address.md): Retrieve all lead score cards for the contact matching the specified email address. - [Get all segments that the contact belong by email address](https://developer.act-on.com/reference/get-all-segments-that-the-contact-belong-by-email-address.md): Retrieve all segments that the contact matching the specified email address belongs to. - [Get contact history by externalId and object type](https://developer.act-on.com/reference/get-contact-history-by-externalid-and-object-type.md): Retrieve the activity timeline history for the contact matching the specified external ID and object type. - [Get all scores for a contact by externalId and object type](https://developer.act-on.com/reference/get-all-scores-for-a-contact-by-externalid-and-object-type.md): Retrieve all lead score cards for the contact matching the specified external ID and object type. - [Get all segments that the contact belong by externalId and object type](https://developer.act-on.com/reference/get-all-segments-that-the-contact-belong-by-externalid-and-object-type.md): Retrieve all segments that the contact matching the specified external ID and object type belongs to. - [Get contact history by id](https://developer.act-on.com/reference/get-contact-history-by-id.md): Retrieve the activity timeline history for the contact matching the specified record ID. - [Get all scores for a contact by id](https://developer.act-on.com/reference/get-all-scores-for-a-contact-by-id.md): Retrieve all lead score cards for the contact matching the specified record ID. - [Get all segments that the contact belong by id](https://developer.act-on.com/reference/get-all-segments-that-the-contact-belong-by-id.md): Retrieve all segments that the contact matching the specified record ID belongs to. - Schema Management - [Get Schema](https://developer.act-on.com/reference/get-schema.md): Retrieve the Act-On Contacts List schema, including all field definitions. - [Add Field](https://developer.act-on.com/reference/add-field.md): Add a new field (standard or custom) to the Act-On Contacts List schema. - [Update FieldDefinition](https://developer.act-on.com/reference/update-fielddefinition.md): Update the definition of an existing field in the Act-On Contacts List schema. The response returns a new `fieldId` for the updated field — use that ID for later calls; the original ID no longer… - [Delete Field](https://developer.act-on.com/reference/delete-field.md): Delete a field from the Act-On Contacts List schema. - Segment Management - [Get Segments](https://developer.act-on.com/reference/get-segments.md): Retrieve a paginated list of segments defined in your account. - [Create a segment](https://developer.act-on.com/reference/create-a-segment.md): Create a new segment in your account. - [Get Segment by Id](https://developer.act-on.com/reference/get-segment-by-id.md): Retrieve a single segment by its ID. - [Update Segment. If it's a Direct Select Segment, only the name can be updated.](https://developer.act-on.com/reference/update-segment-if-its-a-direct-select-segment-only-the-name-can-be-updated.md): Update an existing segment's definition. For a Direct Select segment, only the name field can be changed — its membership criteria cannot be updated through this endpoint. - [Delete Segment](https://developer.act-on.com/reference/delete-segment.md): Delete a segment from your account. - [Get Contacts from a Segment](https://developer.act-on.com/reference/get-contacts-from-a-segment.md): Retrieve a paginated list of contacts that belong to the specified segment. - [Add Contacts to a Direct Select Segment](https://developer.act-on.com/reference/add-contacts-to-a-direct-select-segment.md): Add contacts by record ID to a Direct Select segment. - [Remove Contacts from Direct Select Segment](https://developer.act-on.com/reference/remove-contacts-from-direct-select-segment.md): Remove contacts by record ID from a Direct Select segment. - [Remove Contacts from Direct Select Segment by email](https://developer.act-on.com/reference/remove-contacts-from-direct-select-segment-by-email.md): Remove a contact by email address from a Direct Select segment. Send a `Content-Type: application/json` header even though there is no request body. An invalid `policy` value returns HTTP 200 with… - [Add Contacts to a Direct Select Segment By External id](https://developer.act-on.com/reference/add-contacts-to-a-direct-select-segment-by-external-id.md): Add contacts by external ID and object type to a Direct Select segment. - [Remove Contacts from Direct Select Segment by external id](https://developer.act-on.com/reference/remove-contacts-from-direct-select-segment-by-external-id.md): Remove contacts by external ID and object type from a Direct Select segment. ## API Reference: Custom Objects Service (Beta) - [Overview - READ ME FIRST](https://developer.act-on.com/reference/overview.md) - Custom Objects Query API (Beta) - [Query data from a Custom Data dataset](https://developer.act-on.com/reference/querydata.md): Performs a query on Custom Data dataset with a simple join with Account Object Context - Custom Objects Data API (Beta) - [Creates a new dataset for a Custom Data schema](https://developer.act-on.com/reference/createdataset.md): Creates an empty dataset for a specific Custom Data schema - [Retrieves the details for a dataset using its ID or name](https://developer.act-on.com/reference/describedataset.md): Returns detailed information about a dataset - [Updates a dataset's name and description](https://developer.act-on.com/reference/updatedataset.md): Modifies metadata for an existing dataset - [Deletes the dataset based on the provided dataset Id](https://developer.act-on.com/reference/deletedataset.md): Permanently removes a dataset and all its data - [Ingests a JSON stream for a specific dataset or object](https://developer.act-on.com/reference/ingestjsonstream.md): Processes a JSON data stream for the specified dataset - [Ingests a CSV or JSON file for a specific dataset or object](https://developer.act-on.com/reference/ingestfile.md): Uploads and processes a data file for the specified dataset - [Validates a file against a schema without ingesting data](https://developer.act-on.com/reference/validatefile.md): Checks if a file is valid for the specified schema - [Retrieves a list of all datasets for a specific schema](https://developer.act-on.com/reference/listdatasetsbyschemaid.md): Returns all datasets for a specific custom object schema - [Retrieve the status for the Job Id](https://developer.act-on.com/reference/getjobstatus.md): If complete and not successful, also retrieves the report download endpoint - [Download the report for the provided Job Id](https://developer.act-on.com/reference/getjobreport.md): Returns a report for a completed job - [Retrieves a list of all datasets for the account](https://developer.act-on.com/reference/listalldatasets.md): Returns all datasets available for the account - [Delete records from a dataset based on the provided IDs or ID range](https://developer.act-on.com/reference/deleteids.md): Delete records from a dataset based on the provided IDs or ID range - Custom Objects Schema API (Beta) - [Returns a Custom Data schema](https://developer.act-on.com/reference/getschema.md): Get a Custom Data schema - [Updates a Custom Data schema basic properties](https://developer.act-on.com/reference/updateschema.md): Updates a Custom Data schema basic properties - [Deletes one Custom Data schema](https://developer.act-on.com/reference/deleteschema.md): Deletes one Custom Data schema - [Updates Custom Data schema field properties](https://developer.act-on.com/reference/updatefields.md): Updates a Custom Data schema fields basic properties - [Adds fields to Custom Data schemas](https://developer.act-on.com/reference/addfields.md): Adds fields to Custom Data schemas - [Deletes fields from Custom Data schemas](https://developer.act-on.com/reference/deletefields.md): Deletes fields from Custom Data schemas - [Create a Custom Data schema](https://developer.act-on.com/reference/createschema.md): Create a Custom Data schema - [Returns all Custom Data schemas](https://developer.act-on.com/reference/getallschemas.md): Get all Custom Data schemas - [Deletes all Custom Data schemas](https://developer.act-on.com/reference/deleteallschemas.md): Deletes all Custom Data schemas