Direct Mail Automation and Address Verification APIs
Direct Mail Automation and Address Verification APIs On Nagent, Lob is exposed as a fully-configurable marketing automation integration that any agent can call — 13 actions, and API key authentication. No code is required to wire Lob into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Lob to automate the kinds of tasks marketing automation teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Lob into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Lob, with input parameters and output schema. Drop these into any step of an agent built in Helix.
LOB_CREATE_DOMAINTool to add a new custom domain for creating custom links. Use when you need to register a domain for short link customization.
Input parameters
The registered domain/hostname.
URL to redirect customers if a short link is broken or inactive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LOB_CREATE_LINKTool to create a shortened URL from a long URL using Lob's link shortening service. Use when you need to shorten a long URL either by using a custom domain or Lob's own short domain.
Input parameters
The unique path for the shortened URL. If empty, a unique path will be automatically generated.
The title of the URL.
The registered domain to be used for the short URL. Defaults to 'lob.st'.
Use metadata to store custom information for tagging and labeling back to your internal systems. Must be an object with up to 20 key-value pairs. Keys must be at most 40 characters and values must be at most 500 characters. Neither can contain the characters `"` and `\\`.
The original target URL to be shortened.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LOB_DELETE_DOMAINTool to delete a registered domain. Use only after confirming all associated links with the domain are deleted.
Input parameters
Unique identifier for a domain.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LOB_DELETE_LINKTool to delete a shortened link. Use when you need to remove a previously created short link from the system.
Input parameters
Unique identifier for a link.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LOB_DELETE_UPLOADTool to delete an existing upload by its unique identifier. Use when you need to permanently remove an upload and its associated data.
Input parameters
Unique identifier of the upload to delete. Format: 'upl_' followed by alphanumeric characters (e.g., 'upl_test'). This permanently deletes the upload and its associated data.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LOB_GET_DOMAINTool to retrieve details for a single domain from Lob. Use when you need to get configuration status, redirect links, or other metadata for a specific domain.
Input parameters
Unique identifier for a domain.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LOB_GET_LINKTool to retrieve a single shortened link. Use when you need to fetch details about a specific link by its ID.
Input parameters
Unique identifier for a link.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LOB_LIST_DOMAINSTool to retrieve a list of all created domains. Use when you need to view or manage custom domains configured for URL shortening. Supports pagination and filtering by configuration status.
Input parameters
A reference to a list entry used for paginating to the next set of entries. Cannot be used with 'before'.
How many results to return. Maximum of 100 results per request.
A reference to a list entry used for paginating to the previous set of entries. Cannot be used with 'after'.
Status of domain configuration.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LOB_LIST_LINKSTool to retrieve a list of shortened links. The list is sorted by creation date, with the most recently created appearing first. Use when you need to view all links or filter by campaign or domain.
Input parameters
Cursor for pagination. Retrieve results after this cursor. Cannot be used with 'before'.
How many results to return. Default is 10.
Cursor for pagination. Retrieve results before this cursor. Cannot be used with 'after'.
Filters links by the provided domain id.
Filters resources created by the provided campaign id, prefixed with 'cmp_'. In the case of snap packs, booklets, and letters with size 'us_legal', however, the campaign id is prefixed with 'camp_' instead of 'cmp_'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LOB_LIST_QR_CODE_ANALYTICSTool to retrieve a list of your QR codes and their analytics data. The QR codes are returned sorted by scan date, with the most recently scanned QR codes appearing first.
Input parameters
How many results to return.
An integer that designates the offset at which to begin returning results. Defaults to 0.
Request that the response include the total count by specifying include=\["total_count"\].
Filter list of responses to only include QR codes with at least one scan event.
Filter by date created. Accepted formats are ISO-8601 date or datetime, e.g. { "gt": "2012-01-01", "lt": "2012-01-31T12:34:56Z" } where "gt" is >, "lt" is <, "gte" is ≥, and "lte" is ≤.
Filter by the resource ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LOB_LIST_UPLOADSTool to list uploads from Lob. Use when you need to retrieve all uploads or filter uploads by campaign ID.
Input parameters
ID of the campaign to filter uploads by. If provided, only returns uploads associated with this campaign.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LOB_UPDATE_LINKTool to update any properties of a shortened link. Use when you need to modify the redirect URL, title, or metadata of an existing Lob shortened link. Requires the link_id and at least the redirect_link to update.
Input parameters
The title of the URL. Useful for organizing and identifying links.
Unique identifier for the link to update. Must be a valid link ID prefixed with 'lnk_'.
Use metadata to store custom information for tagging and labeling back to your internal systems. Must be an object with up to 20 key-value pairs. Keys must be at most 40 characters and values must be at most 500 characters. Neither can contain the characters '"' and '\\'. Example: {'customer_id': 'NEWYORK2015'}. Nested objects are not supported.
The original target URL to redirect to when the shortened link is accessed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
LOB_VALIDATE_IDENTITYTool to validate whether a given name is associated with an address. Use when you need to verify identity information by checking if a recipient name matches address records.
Input parameters
City name
State abbreviation (2 characters)
ZIP code (5 or 9 digits)
Full name of the recipient to validate against the address
Primary address line (street address)
Secondary address line (apartment, suite, etc.)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 47 agents privately built on Nagent that already use Lob.
Build on Nagent
Connect Lob to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Lob, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Lob is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Lob is connected, you configure its 13 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Lob steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Lob event fires, the agent kicks off automatically.
Every Lob action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Lob ships with 13 pre-built marketing automation actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Lob together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Lob-based workflows tailored to your business.