diff --git a/docs/index.html b/docs/index.html index 23662ac7..63c5041f 100644 --- a/docs/index.html +++ b/docs/index.html @@ -3007,7 +3007,7 @@ 55.627 l 55.6165,55.627 -231.245496,231.24803 c -127.185,127.1864 -231.5279,231.248 -231.873,231.248 -0.3451,0 -104.688, -104.0616 -231.873,-231.248 z - " fill="currentColor">
The Lob API is organized around REST. Our API is designed to have predictable, resource-oriented URLs and uses HTTP response codes to indicate any API errors.
+ " fill="currentColor">The Lob API is organized around REST. Our API is designed to have predictable, resource-oriented URLs and uses HTTP response codes to indicate any API errors.
Lob’s Print & Mail and Address Verification APIs help companies transform outdated, manual print-and-mail processes; save 1,000s of hours in processing time by sending mail much more quickly; and increase ROI on offline communications.
@@ -3268,7 +3268,7 @@An array of tracking_event objects ordered by ascending time
. Will not be populated for postcards created in test mode.
Denotes 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_
.
The use type for each mailpiece. Can be one of marketing, operational, or null. Null use_type is only allowed if an account default use_type is selected in Account Settings. For more information on use_type, see our Help Center article.
-This is in beta. Contact support@lob.com or your account contact to learn more. Not available for 4x6
or A5
postcard sizes.
This is in beta. Contact support@lob.com or your account contact to learn more. Not available for 4x6
or A5
postcard sizes.
A string describing the PDF render status:
processed
- the rendering process is currently in progress.Required if to
address is international. Must either be an address ID or an inline object with correct address parameters. Must either be an address ID or an inline object with correct address parameters. All addresses will be standardized into uppercase without being modified by verification.
An optional string with the billing group ID to tag your usage with. Is used for billing purposes. Requires special activation to use. See Billing Group API for more information.
Customize and place a QR code on the creative at the required position.
-This is in beta. Contact support@lob.com or your account contact to learn more. Not available for 4x6
or A5
postcard sizes.
This is in beta. Contact support@lob.com or your account contact to learn more. Not available for 4x6
or A5
postcard sizes.
ratelimit-limit | integer Example: 150 The rate limit for a given endpoint. |
ratelimit-remaining | integer Example: 100 The number of requests remaining in the current window. @@ -3393,7 +3393,7 @@3. Learn more |
Array of objects or null (tracking_event_normal) An array of tracking_event objects ordered by ascending | |
campaign_id | string or null (campaign_id) ^(cmp|camp)_[a-zA-Z0-9]+$ Denotes resources created by the provided campaign id, prefixed with |
use_type | string or null (psc_use_type) Enum: "marketing" "operational" null The use type for each mailpiece. Can be one of marketing, operational, or null. Null use_type is only allowed if an account default use_type is selected in Account Settings. For more information on use_type, see our Help Center article. - |
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for |
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for |
status | string (status) Enum: "processed" "rendered" "failed" A string describing the PDF render status:
3. Learn more |
merge_variables | object or null (merge_variables) <= 25000 characters You can input a merge variable payload object to your template or QR code redirect URLs to render dynamic content. For example, if you have a template like: |
string or string (send_date) A timestamp in ISO 8601 format which specifies a date after the current time and up to 180 days in the future to send the letter off for production. Setting a send date overrides the default cancellation window applied to the mailpiece. Until the | |
size | string (self_mailer_size) Default: "6x18_bifold" Enum: "6x18_bifold" "11x9_bifold" "12x9_bifold" "17.75x9_trifold" Specifies the size of the self mailer. The |
size | string (self_mailer_size) Default: "6x18_bifold" Enum: "6x18_bifold" "11x9_bifold" "12x9_bifold" "17.75x9_trifold" Specifies the size of the self mailer. The |
Array of objects (thumbnail) | |
expected_delivery_date | string <date> (expected_delivery_date) A date in YYYY-MM-DD format of the mailpiece's expected delivery date based on its |
date_created | string <date-time> (date_created) A timestamp in ISO 8601 format of the date the resource was created. |
date_modified | string <date-time> (date_modified) A timestamp in ISO 8601 format of the date the resource was last modified. @@ -3435,7 +3435,7 @@3. Learn more |
inside_template_version_id | string or null^vrsn_[a-zA-Z0-9]+$ The unique ID of the specific version of the HTML template used for the inside of the self mailer. |
object | string Default: "self_mailer" Value: "self_mailer" Value is resource type. |
Array of objects (tracking_event_certified) An array of certified tracking events ordered by ascending | |
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for |
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for |
status | string (status) Enum: "processed" "rendered" "failed" A string describing the PDF render status:
3. Learn more |
merge_variables | object or null (merge_variables) <= 25000 characters You can input a merge variable payload object to your template or QR code redirect URLs to render dynamic content. For example, if you have a template like: |
string or string (send_date) A timestamp in ISO 8601 format which specifies a date after the current time and up to 180 days in the future to send the letter off for production. Setting a send date overrides the default cancellation window applied to the mailpiece. Until the | |
size | string (self_mailer_size) Default: "6x18_bifold" Enum: "6x18_bifold" "11x9_bifold" "12x9_bifold" "17.75x9_trifold" Specifies the size of the self mailer. The |
size | string (self_mailer_size) Default: "6x18_bifold" Enum: "6x18_bifold" "11x9_bifold" "12x9_bifold" "17.75x9_trifold" Specifies the size of the self mailer. The |
adr_id (string) or (address_editable_us (address obj with `name` defined (object) or address obj with `company` defined (object))) Required if | |
billing_group_id | string (billing_group_id) An optional string with the billing group ID to tag your usage with. Is used for billing purposes. Requires special activation to use. See Billing Group API for more information. |
object (qr_code) Customize and place a QR code on the creative at the required position. - | |
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for |
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for |
ratelimit-limit | integer Example: 150 The rate limit for a given endpoint. | ||||||||||||||||||||||||||
ratelimit-remaining | integer Example: 100 The number of requests remaining in the current window. @@ -3549,7 +3549,7 @@3. Learn more | ||||||||||||||||||||||||||
merge_variables | object or null (merge_variables) <= 25000 characters You can input a merge variable payload object to your template or QR code redirect URLs to render dynamic content. For example, if you have a template like: | ||||||||||||||||||||||||||
string or string (send_date) A timestamp in ISO 8601 format which specifies a date after the current time and up to 180 days in the future to send the letter off for production. Setting a send date overrides the default cancellation window applied to the mailpiece. Until the | |||||||||||||||||||||||||||
size | string (self_mailer_size) Default: "6x18_bifold" Enum: "6x18_bifold" "11x9_bifold" "12x9_bifold" "17.75x9_trifold" Specifies the size of the self mailer. The | ||||||||||||||||||||||||||
size | string (self_mailer_size) Default: "6x18_bifold" Enum: "6x18_bifold" "11x9_bifold" "12x9_bifold" "17.75x9_trifold" Specifies the size of the self mailer. The | ||||||||||||||||||||||||||
Array of objects (thumbnail) | |||||||||||||||||||||||||||
expected_delivery_date | string <date> (expected_delivery_date) A date in YYYY-MM-DD format of the mailpiece's expected delivery date based on its | ||||||||||||||||||||||||||
date_created | string <date-time> (date_created) A timestamp in ISO 8601 format of the date the resource was created. | ||||||||||||||||||||||||||
date_modified | string <date-time> (date_modified) A timestamp in ISO 8601 format of the date the resource was last modified. @@ -3560,7 +3560,7 @@3. Learn more | ||||||||||||||||||||||||||
inside_template_version_id | string or null^vrsn_[a-zA-Z0-9]+$ The unique ID of the specific version of the HTML template used for the inside of the self mailer. | ||||||||||||||||||||||||||
object | string Default: "self_mailer" Value: "self_mailer" Value is resource type. | ||||||||||||||||||||||||||
Array of objects (tracking_event_certified) An array of certified tracking events ordered by ascending | |||||||||||||||||||||||||||
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for | ||||||||||||||||||||||||||
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for | ||||||||||||||||||||||||||
status | string (status) Enum: "processed" "rendered" "failed" A string describing the PDF render status:
3. Learn more | ||||||||||||||||||||||||||
template_id | string^tmpl_[a-zA-Z0-9]+$ The unique ID of the HTML template used for the letter. | ||||||||||||||||||||||||||
template_version_id | string^vrsn_[a-zA-Z0-9]+$ The unique ID of the specific version of the HTML template used for the letter. | ||||||||||||||||||||||||||
campaign_id | string or null (campaign_id) ^(cmp|camp)_[a-zA-Z0-9]+$ Denotes resources created by the provided campaign id, prefixed with | ||||||||||||||||||||||||||
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for | ||||||||||||||||||||||||||
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for | ||||||||||||||||||||||||||
status | string (status) Enum: "processed" "rendered" "failed" A string describing the PDF render status:
3. Learn moreResponse samples
Content type application/json { CreateCreates a new letter given information Authorizations:basicAuth query Parameters
header Parameters
Request Body schema:
Responses | ||||||||||||||||||||||||||
template_id | string^tmpl_[a-zA-Z0-9]+$ The unique ID of the HTML template used for the letter. | ||||||||||||||||||||||||||
template_version_id | string^vrsn_[a-zA-Z0-9]+$ The unique ID of the specific version of the HTML template used for the letter. | ||||||||||||||||||||||||||
campaign_id | string or null (campaign_id) ^(cmp|camp)_[a-zA-Z0-9]+$ Denotes resources created by the provided campaign id, prefixed with | ||||||||||||||||||||||||||
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for | ||||||||||||||||||||||||||
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for | ||||||||||||||||||||||||||
status | string (status) Enum: "processed" "rendered" "failed" A string describing the PDF render status:
3. Learn more | ||||||||||||||||||||||||||
inside_template_version_id | string or null^vrsn_[a-zA-Z0-9]+$ The unique ID of the specific version of the HTML template used for the inside of the snap pack. | ||||||||||||||||||||||||||
object | string Default: "snap_pack" Value: "snap_pack" Value is resource type. | ||||||||||||||||||||||||||
Array of objects (tracking_event_normal) An array of tracking events ordered by ascending | |||||||||||||||||||||||||||
fsc | boolean Default: false Contact support@lob.com or your account contact to learn more. Not available for snap_pack currently. + | ||||||||||||||||||||||||||
fsc | boolean Default: false Contact support@lob.com or your account contact to learn more. Not available for snap_pack currently. | ||||||||||||||||||||||||||
status | string (status) Enum: "processed" "rendered" "failed" A string describing the PDF render status:
3. Learn more | ||||||||||||||||||||||||||
inside_template_version_id | string or null^vrsn_[a-zA-Z0-9]+$ The unique ID of the specific version of the HTML template used for the inside of the snap pack. | ||||||||||||||||||||||||||
object | string Default: "snap_pack" Value: "snap_pack" Value is resource type. | ||||||||||||||||||||||||||
Array of objects (tracking_event_normal) An array of tracking events ordered by ascending | |||||||||||||||||||||||||||
fsc | boolean Default: false Contact support@lob.com or your account contact to learn more. Not available for snap_pack currently. + | ||||||||||||||||||||||||||
fsc | boolean Default: false Contact support@lob.com or your account contact to learn more. Not available for snap_pack currently. | ||||||||||||||||||||||||||
status | string (status) Enum: "processed" "rendered" "failed" A string describing the PDF render status:
3. Learn more | ||||||||||||||||||||||||||
campaign_id | string or null (campaign_id) ^(cmp|camp)_[a-zA-Z0-9]+$ Denotes resources created by the provided campaign id, prefixed with | ||||||||||||||||||||||||||
size | string (booklet_size) Default: "8.375x5.375" Value: "8.375x5.375" Specifies the size of the booklet. | ||||||||||||||||||||||||||
pages | integer (booklet_pages) Pages specifies the total number of pages in a booklet, where four pages make up one sheet. Pages must always be in increments of four to maintain booklet integrity. For a booklet with dimensions of 8.375x5.375 inches, we allow for 8, 12, 16, 20, 24, 28, or 32 pages. - | ||||||||||||||||||||||||||
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. + | ||||||||||||||||||||||||||
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. | ||||||||||||||||||||||||||
status | string (status) Enum: "processed" "rendered" "failed" A string describing the PDF render status:
3. Learn more | ||||||||||||||||||||||||||
string or string (send_date) A timestamp in ISO 8601 format which specifies a date after the current time and up to 180 days in the future to send the letter off for production. Setting a send date overrides the default cancellation window applied to the mailpiece. Until the | |||||||||||||||||||||||||||
billing_group_id | string (billing_group_id) An optional string with the billing group ID to tag your usage with. Is used for billing purposes. Requires special activation to use. See Billing Group API for more information. | ||||||||||||||||||||||||||
object (qr_code) Customize and place a QR code on the creative at the required position. - | |||||||||||||||||||||||||||
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for | ||||||||||||||||||||||||||
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. Not available for | ||||||||||||||||||||||||||
source_material | string (booklet_source_material) Default: "60# Gloss Text" Value: "60# Gloss Text" Defines the material used to create the mail piece, specifically for booklets. This property is directly tied to the size of the booklet, ensuring that the appropriate material is selected based on the booklet's dimensions. For booklets with |
ratelimit-limit | integer Example: 150 The rate limit for a given endpoint. @@ -4238,7 +4238,7 @@3. Learn more |
campaign_id | string or null (campaign_id) ^(cmp|camp)_[a-zA-Z0-9]+$ Denotes resources created by the provided campaign id, prefixed with |
size | string (booklet_size) Default: "8.375x5.375" Value: "8.375x5.375" Specifies the size of the booklet. |
pages | integer (booklet_pages) Pages specifies the total number of pages in a booklet, where four pages make up one sheet. Pages must always be in increments of four to maintain booklet integrity. For a booklet with dimensions of 8.375x5.375 inches, we allow for 8, 12, 16, 20, 24, 28, or 32 pages. - |
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. + |
fsc | boolean Default: false This is in beta. Contact support@lob.com or your account contact to learn more. |
status | string (status) Enum: "processed" "rendered" "failed" A string describing the PDF render status:
Changelog |