Gradient Works Docs
ProductDynamic BooksPricingRequest Demo
  • Welcome
  • ACCOUNT RESEARCH
    • Overview
      • Features
    • Market Map
      • Account Import
        • Salesforce
        • HubSpot
      • Salesforce Integration
        • How to Install Similar Accounts Component
      • CRM Export
        • Salesforce
        • HubSpot
      • FAQs
        • Attributes in Market Map
    • AI Researcher
      • How to create & configure an AI Researcher
      • Writing effective prompts
      • Prompt examples
      • Managed AI Researcher
    • Lookalikes
    • Credits
  • Bookbuilder
    • Overview
    • Enroll Accounts
    • Target Books
      • Target Book Report
      • Edit Reps
    • Account Coverage
      • Market Coverage
      • Rep Coverage
      • Working Activities
    • Transfer Accounts
      • Concepts
      • Account Pool
      • Distributions
      • Retrievals
      • Returns
      • Templates
      • Scheduling
      • Troubleshooting
    • How-to Guides
      • How to Rank Accounts for Distributions and Retrievals
      • How to Use the "Is In" Operator
  • Routing
    • Overview
    • Dashboard
    • Round Robin Queues
      • Create Queues
      • User Availability Status
      • User Working Hours
    • Users
    • Capacity Meters
    • Lead and Account Matching
    • Automation
      • Automation Executions
      • Log Entries
  • Automation Builder Kit (ABK)
    • Getting Started
    • Actions
      • Assignment
        • Directly Assign Items
        • Round Robin Assign Single Item
        • Round Robin Assign Multiple Items
        • Schedule and Assign Single Item
      • Dynamic Books
        • Retrieval
      • Flow Lifecycle
        • Execute Subflow
        • Failed
        • Finish
        • Resume
        • Start
      • Leads
        • Convert Lead
        • Convert Multiple Leads
      • Logs
        • Log Message
      • Matching
        • Match Account to Account
        • Match Lead to Account
        • Match Lead to Contact
        • Match Lead to Lead
      • Next Steps
        • Add Person to Campaign
        • Add Person to Sales Engagement Cadence
        • Check Person Enrollment in Cadence
        • Create Task
        • Send Single Assignment Email
        • Send Slack Message
      • Users
        • Get Used Capacity
        • Update Capacity
        • Update Weight
      • Utils
        • Evaluate Domain against Denylist
      • Advanced
        • Build Record Map from Lookup
        • Build Record Map from Field
        • Build Text Collection from Field
        • Convert ItemAssigned to Assignment
        • Execute SOQL
        • Get Record from Record Map
        • Assign Pending Items for Multiple Queues
        • Assign Pending Items for Single Queue
        • Enqueue Multiple Items
        • Enqueue Single Item
    • Models
      • AccountMatchResult
      • AccountToAccountMatch
      • Assignment
      • ConvertLeadRequest
      • ConvertLeadResult
      • DomainEvaluationResult
      • GenericSObject
      • LeadToAccountMatch
      • LeadToContactMatch
      • LeadToLeadMatch
      • QueueUserWeight
      • RecordMap
  • Integrations
    • Getting Started
    • Slack
    • Google Workspace
    • Microsoft 365
    • Salesloft
    • Outreach
  • Advanced
    • Salesforce Permissions
  • Miscellaneous
    • Changelog
Powered by GitBook
On this page
  1. Bookbuilder
  2. Transfer Accounts

Troubleshooting

What to do if you see retrieval or distribution errors

PreviousSchedulingNextHow-to Guides

Last updated 9 months ago

If you're a Gradient Works customer with an issue or you have questions about how to properly tune distributions and retrievals for your org, let us know. Contact your CSM directly or email .

Let's face it, Salesforce is a complicated beast. Many of us have Salesforce orgs with lots of extra fields, some crufty data as well as more triggers and automations than we care to admit.

The first time you run a distribution or a retrieval you may see an error, especially if you have a lot of data validations or automations that run when an account is updated. This type of issue can usually be fixed by adjusting the batch size of the account transfer process.

To tune this, go to "Settings" in the left nav and expand "Distribution and Retrieval Processing".

Adjust the following settings and click "Save Changes".

Async Threshold - controls when Bookbuilder decides to run the transfer process as a Salesforce job vs running it immediately. This setting exists because small distributions can complete faster if they're run immediately (synchronously). If you're seeing errors even on small distributions, set this number lower. Start with 100 and work your way down.

Batch Size - controls how many accounts Bookbuilder attempts to process in a single batch transaction. Tuning this setting higher will allow large distributions and retrievals to run faster but will make the process more likely to hit . If you're running into problems with your transfers due to errors with triggered automations, try reducing this number. Start with 100 and work your way down.

batch
governor limits
support@gradient.works
Settings for distribution and retrieval processing