For the complete documentation index, see llms.txt. This page is also available as Markdown.

SlapFive API

SlapFive has a powerful Application Programming Interface (API) that includes webhooks, GET and POST endpoints.

Authentication

When making requests to any SlapFive API endpoint, you must include api-authorization as a key in the HTTP header, with your API Key as the value. To find or generate your API Key, go to your Admin menu and click Client Settings, and scroll down to the API Keys section, where you can copy and paste the value that appears, or generate a new one.

Pagination

For using GET endpoints to retrieve more than 1,000 records, SlapFive recommends using pagination to retrieve 1,000 records at a time. To do this, include the limit and the offset parameters as URL parameters like this:

?limit=1000&offset=0

or in the body of the request, like this:

{
  "limit": 1000,
  "offset": 0
}

Created and Last Updated Dates

The SlapFive API GET endpoints all include the Created Date and Last Updated Date for each record in their response output, like this:

{
 "createdAt":"2025-03-06T20:27:45.111289+00:00",
 "updatedAt":"2025-03-06T20:43:45.122277+00:00"
}

Get Records based on Last Updated Dates

You can append GET URLs with these two parameters to get records that have been updated within a certain period:

This gets all records with an updatedAt date since Junuary 1, 2026, or whatever date you insert.

This gets all records with an updatedAt date within the last 1,000 hours, or whatever hours you insert.

These parameters are enabled for these objects: Activities, Boards, Companies, Members, Page Views, Requests, Request Fulfillment Companies/Members, Request Fulfillment Boards, Shares, and Stories.

Get Specific Fields

You can append GET URLs with the field names of the fields you want returned, rather than return all fields, like this example for pulling Member (customer) fields:

You can also specify the names of fields from related objects, like this example for pulling Company information for the Members:

Get Data with Role Filters Applied

You can append GET URLs with scope=Role to filter the data returned using the Role Filters for the specified Role. For example, to filter Company data by the filter for the Company entity defined in the Salesforce Role:

Available API endpoints


Boards

Get all Boards

This API returns all Boards in an array, with the Board Name and Board ID.

Method: GET URL: https://your_company.slapfive.com/api/api/boards/

Get Boards created or changed in last XX hours

This returns Boards that have been created or changed within the specified number of hours.

Method: GET URL: https://your_company.slapfive.com/api/api/boards/?hoursBack=XX

Get specific Board and its Stories

This API accepts a Board ID as parameter and returns that Board along with all the Stories on that Board. The Stories are returned with all the data about the Customer who contributed the Story.

Method: GET URL: https://your_company.slapfive.com/api/api/boards/<boardID>

Webhook for new or changed Board

Subscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/subscribe

body:

Unsubscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/unsubscribe

body:

Create or update Board

If a Board record exists for the id provided, it updates that record, otherwise it creates a new record. In either case it returns the id.

Method: POST URL: https://your_company.slapfive.com/api/api/boards/ Required: id OR name. storyIds: passing storyIds will remove all currently attached Stories from the Board and add the Stories that correspond to the storyIds in the order in which they are provided in the array. Sample JSON request data:

Sample JSON output:

Delete Board

Delete a Board record by id.

Method: POST URL: https://your_company.slapfive.com/api/api/boards/delete

Sample JSON request data:


Stories

Get all Stories

This API returns all Stories, in an array, with all the information from the Story and the Customer who contributed the Story.

Method: GET URL: https://your_company.slapfive.com/api/api/stories/

Get Stories created or changed in last XX hours

This API returns Stories that have been created or changed within the specified number of hours.

Method: GET URL: https://your_company.slapfive.com/api/api/stories/?hoursBack=XX

Get specific Story

This API accepts a Story ID as parameter and returns that Story with all the data about the Customer who contributed the Story.

Method: GET URL: https://your_company.slapfive.com/api/api/stories/<storyID>

Webhook for new or changed Story

Subscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/subscribe

body:

Unsubscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/unsubscribe

body:

Create or update Story

If a Story record exists for the id provided, it updates that record, otherwise it creates a new record. In either case it returns the id.

Method: POST URL: https://your_company.slapfive.com/api/api/stories/ Required for updating a Story: id Required for creating a new Story: customerId OR customerEmail, promptId type (if media is provided, type will be determined from the media) Sample JSON request data:

Sample JSON output:

Delete Story

Delete a Story record by id.

Method: POST URL: https://your_company.slapfive.com/api/api/stories/delete

Sample JSON request data:


Members

Get all Members

Method: GET URL: https://your_company.slapfive.com/api/api/customers/

Get Members created or changed in last XX hours

Method: GET URL: https://your_company.slapfive.com/api/api/customers/?hoursBack=XX

Get a specific Member by ID

Method: GET URL: https://your_company.slapfive.com/api/api/customers/<memberID>

Get a specific Member by Email Address

Method: GET URL: https://your_company.slapfive.com/api/api/customers/<email>

Webhook for new or changed Member

Subscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/subscribe

body:

Unsubscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/unsubscribe

body:

Create or update Member

If a Member record exists with the id, email or salesforceContactId provided, it updates that record, otherwise it creates a new record. In either case it returns the id.

Method: POST URL: https://your_company.slapfive.com/api/api/customers/ Required for updating a Member: id OR email OR salesforceContactId. Required for creating new Member: email, fname, lname, companyName. Required for updating the Member's salesforceContactId: id, new salesforceContactId.

Logic for associating Member with Company:

  • If the companyName and/or companySalesforceAccountId MATCH either of those values for the Company that the Member currently belongs to, keep the Member attached to that Company.

  • If the companyName and/or companySalesforceAccountId DO NOT MATCH either of those values for the Company that the Member currently belongs to, but MATCH another Company, associate the Member with that matching Company.

  • If the companyName and/or companySalesforceAccountId DO NOT MATCH either of those values for the Company that the Member currently belongs to, and DO NOT MATCH another Company, create a new Company and associate the Member with that new Company.

Sample JSON request data:

Sample JSON output:

Create or update Members in Bulk

Use the same input fields and rules, but pass multiple objects within an array. The maximum body array size is 1000.

Delete Member

Delete a Member record by id.

Method: POST URL: https://your_company.slapfive.com/api/api/customers/delete

Sample JSON request data:


Companies

Get all Companies

Method: GET URL: https://your_company.slapfive.com/api/api/companies/ By default, this endpoint gets Companies changed in the last 24 hours. To also get Companies changed more than 24 hours ago, append the URL with /?hoursBack=XX as described in Get Companies That Have Been Created or Changed in the Last XX Hours.

Get a specific Company by ID

Method: GET URL: https://your_company.slapfive.com/api/api/companies/<id>

Get Companies created or changed in last XX hours

Method: GET URL: https://your_company.slapfive.com/api/api/companies/?hoursBack=XX

Webhook for new or changed Company

Subscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/subscribe

body:

Unsubscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/unsubscribe

body:

Create or update Company

If a Company record exists with the name or salesforceAccountId provided, it updates that record, otherwise it creates a new record. In either case it returns the Company ID.

Method: POST URL: https://your_company.slapfive.com/api/api/companies/ Required for updating a Company: name OR salesforceAccountId Required for creating new Member: name Required for updating the Company's name: id, new name. Required for updating the Company's salesforceAccountId: id, new salesforceAccountId.

Sample JSON request data:

Sample JSON output:

Create or update Companies in Bulk

Use the same input fields and rules, but pass multiple objects within an array. The maximum body array size is 1000.

Delete Company

Delete a Company record by id.

Method: POST URL: https://your_company.slapfive.com/api/api/companies/delete

Sample JSON request data:


Activities

Get all Activities

Method: GET URL: https://your_company.slapfive.com/api/api/activityLogs/

Get a specific Activity by ID

Method: GET URL: https://your_company.slapfive.com/api/api/activityLogs/<id>

Get Activities created or changed in last XX hours

Method: GET URL: https://your_company.slapfive.com/api/api/activityLogs/?hoursBack=XX

Webhook for new or changed Activity

Subscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/subscribe

body:

Unsubscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/unsubscribe

body:

Create or update Activity

If an Activity record exists for the id provided, it updates that record, otherwise it creates a new record. In either case it returns the id.

Method: POST URL: https://your_company.slapfive.com/api/api/activity/ Required for creating new Activity: email or customerId, activityName, date Required for updating Activity: id

Sample JSON request data:

Sample JSON output:

Create or update Activities in Bulk

Use the same input fields and rules, but pass multiple objects within an array. The maximum body array size is 1000.

Delete Activity

Delete an Activity record by id.

Method: POST URL: https://your_company.slapfive.com/api/api/activity/delete

Sample JSON request data:


Requests

Get Requests updated in last XX hours

Method: GET URL: https://your_company.slapfive.com/api/api/requests/?hoursBack=XX

Get Requests fulfilled in last XX hours

Method: GET URL: https://your_company.slapfive.com/api/api/requests/?fulfillmentHoursBack=XX

Get a specific Request by ID

Method: GET URL: https://your_company.slapfive.com/api/api/requests/<id>

Webhook for new or changed Request

Subscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/subscribe

body:

Unsubscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/unsubscribe

body:

Create or update Request

If a Request record exists for the id provided, it updates that record, otherwise it creates a new record. In either case it returns the id.

Method: POST URL: https://your_company.slapfive.com/api/api/requests/ Required: needDescription, needByDate Sample JSON request data:

Sample JSON output:

Delete Request

Delete a Request record by id.

Method: POST URL: https://your_company.slapfive.com/api/api/requests/delete

Sample JSON request data:


Fulfillment Members/Companies

Get all Fulfillment Members/Companies

Method: GET URL: https://your_company.slapfive.com/api/api/requestFulfillmentMembers/

Get Fulfillment Members/Companies for a Request

Method: GET URL: https://your_company.slapfive.com/api/api/requestFulfillmentMembers/<requestID>

Get Fulfillment Members/Companies created/changed in last XX hours

Method: GET URL: https://your_company.slapfive.com/api/api/requestFulfillmentMembers/?hoursBack=XX

Get specific Fulfillment Member/Company by ID

Method: GET URL: https://your_company.slapfive.com/api/api/requestFulfillmentMembers/<id>

Webhook for new or changed Fulfillment Member/Company

Subscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/subscribe

body:

Unsubscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/unsubscribe

body:

Create or update Fulfillment Member/Company

If a Request Fulfillment Member record exists for the id provided, it updates that record, otherwise it creates a new record. In either case it returns the id.

Method: POST URL: https://your_company.slapfive.com/api/api/requestFulfillmentCustomers/ Required for creating new Fulfillment Member/Company: request_number or request_id; customer_email, customer_id, or customer_salesforceContactId; company_name, company_id, or company_salesforceAccountId; Required for updating Fulfillment Member/Company: id

Sample JSON request data:

Sample JSON output:


Fulfillment Boards

Get all Fulfillment Boards

Method: GET URL: https://your_company.slapfive.com/api/api/requestFulfillmentBoards/

Get Fulfillment Boards for a Request

Method: GET URL: https://your_company.slapfive.com/api/api/requestFulfillmentBoards/<requestID>

Get Fulfillment Boards created/changed in last XX hours

Method: GET URL: https://your_company.slapfive.com/api/api/requestFulfillmentBoards/?hoursBack=XX

Get specific Fulfillment Board by ID

Method: GET URL: https://your_company.slapfive.com/api/api/requestFulfillmentBoards/<id>

Webhook for new or changed Fulfillment Board

Subscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/subscribe

body:

Unsubscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/unsubscribe

body:

{ ‘webhook_url’: the URL that was subscribed }


Campaigns

Get all Campaigns

Method: GET URL: https://your_company.slapfive.com/api/api/campaigns/

Get specific Campaign by ID

Method: GET URL: https://your_company.slapfive.com/api/api/campaigns/<id>

Webhook for new or changed Campaign

Subscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/subscribe

body:

Unsubscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/unsubscribe

body:


Campaign Items

Get all Campaign Items for a Campaign

Method: GET URL: https://your_company.slapfive.com/api/api/campaigns/<campaignId>/items

Get specific Campaign Item

Method: GET URL: https://your_company.slapfive.com/api/api/campaign-items/<id>

Webhook for new or changed Campaign Item

Subscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/subscribe

body:

Unsubscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/unsubscribe

body:

Create or update Campaign Item

If a Campaign Item record exists for the id provided, it updates that record, otherwise it creates a new record. In either case it returns the id.

Method: POST URL: https://your_company.slapfive.com/api/api/campaigns/<campaignId>/items/ Required URL Parameter: campaignId Required Body Parameters: the object "entities" with name/value pairs in which the name is the Campaign Column Header.

Sample JSON request data:


Content Shares

Get all Content Shares

Method: GET URL: https://your_company.slapfive.com/api/api/shares/

Get a specific Content Share by ID

Method: GET URL: https://your_company.slapfive.com/api/api/shares/<id>

Webhook for new Content Share

Subscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/subscribe

body:

Unsubscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/unsubscribe

body:

Delete Content Share

Delete a Content Share record by id.

Method: POST URL: https://your_company.slapfive.com/api/api/shares/delete

Sample JSON request data:


Content Views

Get all Content Views

Method: GET URL: https://your_company.slapfive.com/api/api/pageViews/

Get a specific Content View by ID

Method: GET URL: https://your_company.slapfive.com/api/api/pageViews/<id>

Webhook for new Content View

Subscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/subscribe

body:

Unsubscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/unsubscribe

body:

Delete Content View

Delete a Content View record by id.

Method: POST URL: https://your_company.slapfive.com/api/api/pageViews/delete

Sample JSON request data:


Surveys & Prompts

Get a Survey and its Responses by ID

Method: GET URL: https://your_company.slapfive.com/api/api/sentSurvey/<id>

Get a Survey's Responses by ID

Method: GET URL: https://your_company.slapfive.com/api/api/sentSurvey/<id>/responses

Get all Prompts

Method: GET URL: https://your_company.slapfive.com/api/api/prompts/

Get a specific Prompt by ID

Method: GET URL: https://your_company.slapfive.com/api/api/prompts/<id>

Send a Prompt

Method: POST URL: https://your_company.slapfive.com/api/api/sendPrompt

Required parameters: customerId, promptId or promptGroupId Optional parameters: customGreeting, customSubject

Delete Prompt

Delete a Prompt record by id.

Method: POST URL: https://your_company.slapfive.com/api/api/prompts/delete

Sample JSON request data:

Webhook for Survey/Prompt Sent/Responded to

Subscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/subscribe

body:

Unsubscribe:

Method: POST URL: https://slapfive.slapfive.com/api/webhooks/unsubscribe

body:

Get all Sent Prompts and Responses

Method: GET URL: https://your_company.slapfive.com/api/api/sent-prompts/

Get a specific Sent Prompt and Response by ID

Method: GET URL: https://your_company.slapfive.com/api/api/sent-prompts/<id>

Get a specific Sent Survey and Response with each Sent Prompt and Response from the Survey by ID

<id> = response_group_id

Method: GET URL: https://your_company.slapfive.com/api/api/sent-prompts/<id>


Opportunities

Get all Opportunities

Method: GET URL: https://your_company.slapfive.com/api/api/opportunities/

Get a specific Opportunity by internal ID

Method: GET URL: https://your_company.slapfive.com/api/api/opportunities/<id>

Get a specific Opportunity by CRM opportunity ID

Method: GET URL: https://your_company.slapfive.com/api/api/opportunities/<opportunity_id>

Create or update Opportunity

If an Opportunity record exists for the id or opportunity_id provided, it updates that record, otherwise it creates a new record. In either case it returns the id.

Method: POST URL: https://your_company.slapfive.com/api/api/opportunities/ Sample JSON request data:

Sample JSON output:

Client Settings

Get Client Settings

Use this endpoint to retrieve Activity Types & Scores, Dynamic Fields, and other Client Settings.

Method: GET URL: https://your_company.slapfive.com/api/api/client

Create or Update Activity Types

If an Activity Type record exists for the id provided, it updates that record, otherwise it creates a new record.

Method: POST URL: https://your_company.slapfive.com/api/api/activity-types/ Required: name OR id Sample JSON request data:

Sample JSON output:

Create or Update Dynamic Field Picklist Values

If a Picklist value record exists for the id provided, it updates that record, otherwise it creates a new record.

Method: POST URL: https://your_company.slapfive.com/api/api/dynamic-fields/:fieldId/picklist-values/ To get the :fieldId, use the Get Client Settings endpoint. Required: name OR id Sample JSON request data:

Sample JSON output:

Prompt the SlapFive AI Assistant

Prompt the AI Assistant and get a response.

Method: POST URL: https://your_company.slapfive.com/api/ai/assistant/ Required: message Sample JSON request data:

Sample JSON output:

Last updated