> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Bread & Butter

> Bread & Butter is a lead-intelligence and identity platform for managing website visitors, profiles, attribution, authentication, and conversion workflows.

![Bread and Butter logo](https://mintcdn.com/composio-preview/PudKL42NVsy5O-ND/images/toolkits/bread_butter.svg?fit=max\&auto=format\&n=PudKL42NVsy5O-ND\&q=85\&s=e57a3a04de56d1f67426f2f9e2fbc2c9)

* **Category:** marketing automation
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 8
* **Triggers:** 0
* **Slug:** `BREAD_BUTTER`
* **Version:** 00000000\_00

## Tools

> [accordion] Get Application
>
> **Slug:** `BREAD_BUTTER_GET_APPLICATION`
>
> Return settings, feature flags, plan details, and lead-status definitions for the application bound to the connected credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Attribution Report
>
> **Slug:** `BREAD_BUTTER_GET_ATTRIBUTION_REPORT`
>
> Return visitor and conversion attribution metrics by reporting period and source for the connected application.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Insights
>
> **Slug:** `BREAD_BUTTER_GET_USER_INSIGHTS`
>
> Return aggregate attribution and user-journey insights for the connected application, with optional top-page and geography detail.
>
> #### Input Parameters
>
> **include\_top\_pages** `boolean`
>
> Include top-page detail within the requested insight sections.
>
> **include\_attribution** `boolean`
>
> Include attribution summaries such as visitor counts and conversion rates.
>
> **include\_user\_journey** `boolean`
>
> Include user-journey summaries such as engagement metrics.
>
> **include\_top\_geography** `boolean`
>
> Include top-city and top-country detail within the requested insight sections.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Applications
>
> **Slug:** `BREAD_BUTTER_LIST_APPLICATIONS`
>
> List Bread & Butter applications available to the connected credentials, optionally filtering by status or name; returns one page and a continuation cursor.
>
> #### Input Parameters
>
> **active** `boolean`
>
> Filter applications by active status; omit to include both active and inactive applications.
>
> **search** `string`
>
> Filter applications using the provider's application search text.
>
> **page\_size** `integer`
>
> Number of applications to request in this page; no provider-wide maximum was live-verified.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Event Definitions
>
> **Slug:** `BREAD_BUTTER_LIST_EVENT_DEFINITIONS`
>
> List configured event definitions for the connected application, optionally filtering by enabled status; returns one page and a continuation cursor.
>
> #### Input Parameters
>
> **enabled** `boolean`
>
> Filter event definitions by whether they are enabled; omit to include both states.
>
> **page\_size** `integer`
>
> Number of event definitions to request in this page; no maximum was live-verified.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Events
>
> **Slug:** `BREAD_BUTTER_LIST_EVENTS`
>
> List tracked activity events for the connected application, optionally scoped to a user or date range; returns one page and a continuation cursor.
>
> #### Input Parameters
>
> **user\_id** `string`
>
> Return only events associated with this Bread & Butter user or profile ID.
>
> **end\_date** `string`
>
> Provider date/time string marking the end of the event range.
>
> **page\_size** `integer`
>
> Number of events to request in this page; the provider default is 25.
>
> **start\_date** `string`
>
> Provider date/time string marking the beginning of the event range.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Lead Lists
>
> **Slug:** `BREAD_BUTTER_LIST_LEAD_LISTS`
>
> Return the saved lead lists configured for the application bound to the connected credentials.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Leads
>
> **Slug:** `BREAD_BUTTER_LIST_LEADS`
>
> List lead and visitor profiles for the connected application, optionally filtering by email address; returns one page and a continuation cursor.
>
> #### Input Parameters
>
> **page\_size** `integer`
>
> Number of lead profiles to request in this page; no maximum was live-verified for this route.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call; omit for the first page.
>
> **email\_address** `string`
>
> Return profiles matching this email address; omit to list profiles without an email filter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
