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
  • Inputs
  • Outputs
  1. Automation Builder Kit (ABK)
  2. Actions
  3. Assignment

Directly Assign Items

Assign a record or records to a specific user or Salesforce native queue.

PreviousAssignmentNextRound Robin Assign Single Item

Last updated 2 years ago

For assignments to Users, we default to using the OwnerId field. If you want to use a different field for assignments to a User, specify that value for the assignment field in the editor. This must be a User lookup field on the item being assigned.

Assignments to Salesforce Queues will always use the OwnerId field.

By default, the assignment is updated immediately in the database. If you want to perform the assignments but delay the update (helpful in bulkifying flows), change Update Item in the editor to "Later, Using Update Records". This will set updateImmediately to false.

Use the assignment or assignments output to see information about the assignments that were performed as part of a Flow run. You can use the individual objects as an input to other actions such as .

Inputs

Please note that you will not directly interact with these input fields as you do with some Flow Actions. Instead the Gradient Works custom editor takes care of the heavy lifting.

Name
Required
Type
Description

assigneeId

No

Id

The Id of the User or Salesforce Queue to assign to.

assigneeName

No

String

Salesforce Queue name

assigneeRecord

No

SObject

User or Salesforce Queue Record to assign item to.

item

No

SObject

The Salesforce object to assign if assigning a single item.

itemField

No

String

The field on the item to use for User assignment. Defaults to OwnerId.

items

No

List<SObject>

The List of Salesforce objects to assign.

updateImmediately

No

Boolean

Set to false to perform the assignment but not to update the item record in the database. Defaults to true.

Outputs

Name
Type
Description

assignment

The first assignment result. Can be used when working with a single item in place of results.

assignments

List<>

The results of all item assignments.

Assignment
Send Single Assignment Email
Assignment
Assignment