lob 5.2.0 → 5.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 58d9c6ae15fcc102d200e7f5658c0ec7ffabe144a5c1c7a5dad4b3d73c7a446c
-  data.tar.gz: b52642eddc9ccad70128c13d9c4a2686216117592e8aa65132742d42dbc5d782
+  metadata.gz: b69d606dfce94ccad4b1bb4cb584a7e3d0ac341e4a117775aba88f31123d0de5
+  data.tar.gz: 8c82f0edfbadfaeb5aac1f922107c138349581ca8f7590ec294dd1141a7c7f6a
 SHA512:
-  metadata.gz: 0704b2ada68338190157031692d209082b261a0701208eb9dbdcac0145a4a014d0a86e13e5b6215e2a57f04f4a26dc253b3bd8113fbdea827fb11f48dfe26c57
-  data.tar.gz: 503e570a1803fc459ce45ba4fb7fc7dd99fae7c0a848d8946db9cbabda744cff5d01edbee6eed88ab207130e0689b6288c751c1c9be27204b4c59311408bf45d
+  metadata.gz: e5f1f78dedb730277f86ce1d4f74105121d72927e1843de558bfbe89546f5cad7e838d0517348619aef0d62e9d1693058efbd57662cd10a24930385f6d11cdd9
+  data.tar.gz: b5475fe1716dda1aaebe194f2f1c8af7fe4f7a9b4a3e55e8124e057c1d76c6d2434631754dcf7bc801c5129e9598b137acda021e5b796ca4a8442eeb77f7704d

data/.github/workflows/run_tests_job.yml

@@ -0,0 +1,36 @@
+name: Run tests
+
+on:
+  pull_request:
+    types: [ created, reopened ]
+    branches:
+      - master
+jobs:
+  ruby_tests:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: ['jruby-9.2.9.0', '2.6', '2.7', '3.0']
+    steps:
+    - uses: actions/checkout@v2
+    - name: Setup
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby-version }}
+    - name: Install Dependencies
+      run: bundle install
+    - name: Run Tests
+      env:
+        API_KEY: ${{ secrets.API_KEY }}
+        JRUBY_OPT: --2.0
+      run: bundle exec rake test
+    - name: Send coverage to Coveralls
+      uses: coverallsapp/github-action@master
+      with:
+        github-token: ${{ secrets.GITHUB_TOKEN }}
+        
+
+
+
+
+  

data/.github/workflows/update_gem.yml

@@ -0,0 +1,30 @@
+name: Publish Gem
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish_gem:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: ['jruby-9.2.9.0', '2.6', '2.7', '3.0']
+    steps:
+    - uses: actions/checkout@v2
+    - name: Setup
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby-version }}
+    - name: Install Dependencies
+      run: bundle install
+    - name: Publish Gem
+      run: |
+        mkdir -p $HOME/.gem
+        touch $HOME/.gem/credentials
+        chmod 0600 $HOME/.gem/credentials
+        printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+        gem build *.gemspec
+        gem push *.gem
+      env:
+        GEM_HOST_API_KEY: "${{secrets.RUBYGEMS_AUTH_TOKEN}}"

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [**5.4.1**](https://github.com/lob/lob-ruby/releases/tag/v5.4.1) (2021-09-28)
+- [**193**](https://github.com/lob/lob-ruby/pull/193) Minor patches
+## [**5.4.0**](https://github.com/lob/lob-ruby/releases/tag/v5.4.0) (2021-09-21)
+- [**191**](https://github.com/lob/lob-ruby/pull/191) Add support for reverse geocoding endpoint
+## [**5.3.0**](https://github.com/lob/lob-ruby/releases/tag/v5.3.0) (2021-08-25)
+- [**190**](https://github.com/lob/lob-ruby/pull/190) Adds support for bulk AV endpoints
 ## [**5.2.0**](https://github.com/lob/lob-ruby/releases/tag/v5.2.0) (2021-05-03)
 - [**188**](https://github.com/lob/lob-ruby/pull/188) Adds support for Self Mailers
 ## 5.1.2 (2021-02-18)

data/README.md

@@ -11,10 +11,14 @@ Supports Ruby 2.0.0 and greater.
 
 ## Table of Contents
 
+- [Table of Contents](#table-of-contents)
 - [Getting Started](#getting-started)
   - [Registration](#registration)
   - [Installation](#installation)
   - [Usage](#usage)
+    - [Initialization and Configuration](#initialization-and-configuration)
+    - [Caution: Pass zero-prefixed zip codes as strings](#caution-pass-zero-prefixed-zip-codes-as-strings)
+    - [Accessing Response Headers](#accessing-response-headers)
 - [Examples](#examples)
 - [API Documentation](#api-documentation)
 - [Contributing](#contributing)
@@ -109,78 +113,7 @@ There are simple scripts to demonstrate how to create all the core Lob objects (
 
 ## API Documentation
 
-- [Introduction](https://lob.com/docs/ruby#introduction)
-- [Versioning](https://lob.com/docs/ruby#version)
-- [Errors](https://lob.com/docs/ruby#errors)
-- [Rate Limiting](https://lob.com/docs/ruby#rate-limits)
-- [Webhooks](https://lob.com/docs/ruby#webhooks)
-- [Cancellation Windows](https://lob.com/docs/ruby#cancellation)
-- [Scheduled Mailings](https://lob.com/docs/ruby#scheduled)
-- [Metadata](https://lob.com/docs/ruby#metadata)
-- [HTML Templates](https://lob.com/docs/ruby#templates)
-- [Asset URLs](https://lob.com/docs/ruby#urls)
-- **Addresses**
-  - [Address Book](https://lob.com/docs/ruby#addresses)
-    - [The Address Object](https://lob.com/docs/ruby#addresses_object)
-    - [Create an Address](https://lob.com/docs/ruby#addresses_create)
-    - [Retrieve an Address](https://lob.com/docs/ruby#addresses_retrieve)
-    - [Delete an Address](https://lob.com/docs/ruby#addresses_delete)
-    - [List all Addresses](https://lob.com/docs/ruby#addresses_list)
-- **US Verification API**
-  - [US Verification API](https://lob.com/docs/ruby#us_verifications)
-    - [The US Verification Object](https://lob.com/docs/ruby#us_verifications_object)
-    - [Verify a US Address](https://lob.com/docs/ruby#us_verifications_create)
-    - [The US Zip Lookup Object](https://lob.com/docs/ruby#us_zip_lookups_object)
-    - [Lookup a US Zip Code](https://lob.com/docs/ruby#us_zip_lookups_create)
-  - [US Autocompletion API](https://lob.com/docs/ruby#us_autocompletions)
-    - [The US Autocompletion Object](https://lob.com/docs/ruby#us_autocompletions_object)
-    - [Autocomplete a US Address](https://lob.com/docs/ruby#us_autocompletions_create)
-    - [The US Autocompletion Test Environment](https://lob.com/docs/ruby#us-autocompletions-test-environment)
-- **Int'l Verification API**
-  - [International Verifications](https://lob.com/docs/ruby#intl_verifications)
-    - [Verify an International Address](https://lob.com/docs/ruby#intl_verifications_create)
-- **Postcards API**
-  - [Postcards](https://lob.com/docs/ruby#postcards)
-    - [The Postcard Object](https://lob.com/docs/ruby#postcards_object)
-    - [Create a Postcard](https://lob.com/docs/ruby#postcards_create)
-    - [Retrieve a Postcard](https://lob.com/docs/ruby#postcards_retrieve)
-    - [Cancel a Postcard](https://lob.com/docs/ruby#postcards_delete)
-    - [List all Postcards](https://lob.com/docs/ruby#postcards_list)
-- **Self Mailers API**
-  - [Self Mailers](https://lob.com/docs/ruby#self_mailers)
-    - [The Self Mailer Object](https://lob.com/docs/ruby#self_mailers_object)
-    - [Create a Self Mailer](https://lob.com/docs/ruby#self_mailers_create)
-    - [Retrieve a Self Mailer](https://lob.com/docs/ruby#self_mailers_retrieve)
-    - [Cancel a Self Mailer](https://lob.com/docs/ruby#self_mailers_delete)
-    - [List all Self Mailers](https://lob.com/docs/ruby#self_mailers_list)
-- **Letters API**
-  - [Letters](https://lob.com/docs/ruby#letters)
-    - [The Letter Object](https://lob.com/docs/ruby#letters_object)
-    - [Create a Letter](https://lob.com/docs/ruby#letters_create)
-    - [Retrieve a Letter](https://lob.com/docs/ruby#letters_retrieve)
-    - [Cancel a Letter](https://lob.com/docs/ruby#letters_delete)
-    - [List all Letters](https://lob.com/docs/ruby#letters_list)
-- **Checks API**
-  - [Checks](https://lob.com/docs/ruby#checks)
-    - [The Check Object](https://lob.com/docs/ruby#checks_object)
-    - [Create a Check](https://lob.com/docs/ruby#checks_create)
-    - [Retrieve a Check](https://lob.com/docs/ruby#checks_retrieve)
-    - [Cancel a Check](https://lob.com/docs/ruby#checks_delete)
-    - [List all Checks](https://lob.com/docs/ruby#checks_list)
-  - [Bank Accounts](https://lob.com/docs/ruby#bank-accounts)
-    - [The Bank Account Object](https://lob.com/docs/ruby#bankaccounts_object)
-    - [Create a Bank Account](https://lob.com/docs/ruby#bankaccounts_create)
-    - [Retrieve a Bank Account](https://lob.com/docs/ruby#bankaccounts_retrieve)
-    - [Delete a Bank Account](https://lob.com/docs/ruby#bankaccounts_delete)
-    - [Verify a Bank Account](https://lob.com/docs/ruby#bankaccounts_verify)
-    - [List all Bank Accounts](https://lob.com/docs/ruby#bankaccounts_list)
-- **Appendix**
-  - [API Changelog](https://lob.com/docs/ruby#changelog)
-  - [The Tracking Event Object](https://lob.com/docs/ruby#tracking_event_object)
-  - [Events](https://lob.com/docs/ruby#events)
-  - [HTML Examples](https://lob.com/docs/ruby#html-examples)
-  - [Image Prepping](https://lob.com/docs/ruby#prepping)
-  - [US Verification Details](https://lob.com/docs/ruby#us_verification_details)
+The full and comprehensive documentation of Lob's APIs is available [here](https://docs.lob.com/).
 
 ## Contributing
 

data/examples/README.md

@@ -1,37 +1,111 @@
 # Ruby Examples
 
-Here we have put together a hand full of ruby examples to help get you started. Please read through the official [API Documentation](../README.md#api-documentation) to get a complete sense of what to expect from each endpoint. As always, feel free to [contact us](https://lob.com/support) directly if you have any questions on implementation.
+Here we have put together a handful of ruby examples to help get you started. Please read through the official [API Documentation](https://docs.lob.com) to get a complete sense of what to expect from each endpoint. As always, feel free to [contact us](https://lob.com/support) directly if you have any questions on implementation. Thank you for using Lob!
 
-## /csv_checks/
+To run these example commands, make sure you have a supported version of Ruby installed, including all the necessary gems.
+
+## [/csv_checks/](./csv_checks/)
 
 An example showing how to dynamically create checks from a CSV using HTML, merge variables, and Lob's [Checks API](https://lob.com/services/checks).
 
-## /csv_letters/
+```
+bundle exec ruby examples/csv_checks/create_checks.rb
+```
+
+## [/csv_letters/](./csv_letters/)
 
 An example showing how to dynamically create letters from a CSV using HTML, a custom font, merge variables, and Lob's [Letters API](https://lob.com/services/letters).
 
-## /csv_postcards/
+```
+bundle exec ruby examples/csv_letters/create_letters.rb
+```
+
+## [/csv_postcards/](./csv_postcards/)
 
 An example showing how to dynamically create postcards from a CSV using HTML, a custom font, merge variables, and Lob's [Postcards API](https://lob.com/services/postcards).
 
-## /csv_verify/
+```
+bundle exec ruby examples/csv_postcards/create_postcards.rb
+```
+
+## [/csv_verify/](./csv_verify/)
 
 An example showing how to validate and cleanse a CSV spreadsheet full of shipping addresses using Lob's [US Verification API](https://lob.com/services/verifications).
   		  
-Please note that if you are running this with a Test API Key, the verification API will always return [a dummy address](https://lob.com/docs#us_verifications_create).
+Please note that if you are running this with a Test API Key, the verification API will always return [a dummy address](https://docs.lob.com/#section/US-Verifications-Test-Env).
+
+```
+bundle exec ruby examples/csv_verify/verify.rb
+```
 
-## /checks.rb
+## [/checks.rb](./checks.rb)
 
 An example showing how to create a check using Lob's [Checks API](https://lob.com/services/checks).
 
-## /letters.rb
+```
+bundle exec ruby examples/checks.rb
+```
+
+## [/letters.rb](./letters.rb)
 
 An example showing how to create a letter using Lob's [Letters API](https://lob.com/services/letters).
 
-## /postcards.rb
+```
+bundle exec ruby examples/letters.rb
+```
+
+## [/postcards.rb](./postcards.rb)
 
 An example showing how to create a postcard using Lob's [Postcards API](https://lob.com/services/postcards).
 
-## /self_mailers.rb
+```
+bundle exec ruby examples/postcards.rb
+```
+
+## [/postcards_idempotent.rb](./postcards_idempotent.rb)
+
+An example showing how to create an idempotent postcard request using Lob's [Postcards API](https://lob.com/services/postcards).
+
+```
+bundle exec ruby examples/postcards_idempotent.rb
+```
+
+## [/postcards_intl.rb](./postcards_intl.rb)
+
+An example showing how to create an international postcard using Lob's [Postcards API](https://lob.com/services/postcards).
+
+```
+bundle exec ruby examples/postcards_intl.rb
+```
+
+## [/postcards_remote.rb](./postcards_remote.rb)
+
+An example showing how to create a postcard with remote files, using Lob's [Postcards API](https://lob.com/services/postcards).
+
+```
+bundle exec ruby examples/postcards_remote.rb
+```
+
+## [/postcards_send_date.rb](./postcards_send_date.rb)
+
+An example showing how to create a postcard with a specified send date, using Lob's [Postcards API](https://lob.com/services/postcards).
+
+```
+bundle exec ruby examples/postcards_send_date.rb
+```
+
+## [/postcards_template.rb](./postcards_template.rb)
+
+An example showing how to create a postcard with a saved template, using Lob's [Postcards API](https://lob.com/services/postcards).
+
+```
+bundle exec ruby examples/postcards_template.rb
+```
+
+## [/self_mailers.rb](./self_mailers.rb)
 
 An example showing how to create a self mailer using Lob's Self Mailers API.
+
+```
+bundle exec ruby examples/self_mailers.rb
+```

data/examples/checks.rb

@@ -1,8 +1,9 @@
 $:.unshift File.expand_path("../lib", File.dirname(__FILE__))
 require 'lob'
+require 'pp'
 
 # initialize Lob object
-lob = Lob::Client.new(api_key: 'YOUR_API_KEY_HERE')
+lob = Lob::Client.new(api_key: 'YOUR_API_KEY')
 
 # create an address
 to_address = lob.addresses.create(
@@ -32,11 +33,11 @@ bank_account = lob.bank_accounts.create(
   signatory: "John Doe"
 )
 
-puts bank_account
+pp bank_account
 lob.bank_accounts.verify(bank_account['id'], amounts: [23, 12])
 
 # send a $100 check using an already created bank and address
-puts lob.checks.create(
+pp lob.checks.create(
   description: "Test Check",
   check_number: "10000",
   bank_account: bank_account["id"],

data/examples/csv_checks/create_checks.rb

@@ -1,9 +1,10 @@
 $:.unshift File.expand_path("../../lib", File.dirname(__FILE__))
 require 'lob'
 require 'csv'
+require 'pp'
 
 # Initialize Lob object
-lob = Lob::Client.new(api_key: 'YOUR_API_KEY_HERE')
+lob = Lob::Client.new(api_key: 'YOUR_API_KEY')
 
 # Create a bank account
 bank_account = lob.bank_accounts.create(
@@ -43,5 +44,5 @@ CSV.foreach(File.expand_path('../input.csv', __FILE__)) do |row|
     amount: row[7],
     memo: "For travel reimbursement"
   )
-  puts check['url']
+  pp check['url']
 end

data/examples/csv_letters/create_letters.rb

@@ -1,9 +1,10 @@
 $:.unshift File.expand_path("../../lib", File.dirname(__FILE__))
 require 'lob'
 require 'csv'
+require 'pp'
 
 # Initialize Lob object
-lob = Lob::Client.new(api_key: 'YOUR_API_KEY_HERE')
+lob = Lob::Client.new(api_key: 'YOUR_API_KEY')
 
 # Load the HTML from letter_template.html
 letter_html = File.open(File.expand_path('../letter_template.html', __FILE__)).read
@@ -36,5 +37,5 @@ CSV.foreach(File.expand_path('../input.csv', __FILE__)) do |row|
     },
     color: false
   )
-  puts letter['url']
+  pp letter['url']
 end

data/examples/csv_postcards/create_postcards.rb

@@ -1,9 +1,10 @@
 $:.unshift File.expand_path("../../lib", File.dirname(__FILE__))
 require 'lob'
 require 'csv'
+require 'pp'
 
 # Initialize Lob object
-lob = Lob::Client.new(api_key: 'YOUR_API_KEY_HERE')
+lob = Lob::Client.new(api_key: 'YOUR_API_KEY')
 
 # Load the HTML from postcard_front.html and postcard_back.html.
 front_html = File.open(File.expand_path('../postcard_front.html', __FILE__)).read
@@ -41,5 +42,5 @@ CSV.foreach(File.expand_path('../input.csv', __FILE__)) do |row|
       mileage: row[4]
     }
   )
-  puts postcard['url']
+  pp postcard['url']
 end

data/examples/csv_verify/verify.rb

@@ -2,9 +2,10 @@ $:.unshift File.expand_path("../../lib", File.dirname(__FILE__))
 
 require 'csv'
 require 'lob'
+require 'pp'
 
 # Initialize Lob object
-lob = Lob::Client.new(api_key: 'YOUR_API_KEY_HERE')
+lob = Lob::Client.new(api_key: 'YOUR_API_KEY')
 
 output = File.open(File.expand_path('../output.csv', __FILE__), 'w')
 
@@ -22,7 +23,7 @@ File.open(File.expand_path('../input.csv', __FILE__)).each_line do |line|
     state: address_components[4],
     zip_code: address_components[5]
   )
-
+  
   output.puts [
     verified_address['primary_line'],
     verified_address['secondary_line'],

data/examples/letters.rb

@@ -1,8 +1,9 @@
 $:.unshift File.expand_path("../lib", File.dirname(__FILE__))
 require 'lob'
+require 'pp'
 
 # initialize Lob object
-lob = Lob::Client.new(api_key: 'YOUR_API_KEY_HERE')
+lob = Lob::Client.new(api_key: 'YOUR_API_KEY')
 
 html = %{
 <html>
@@ -61,7 +62,7 @@ from_address = lob.addresses.create(
 )
 
 # send the letter
-puts lob.letters.create(
+pp lob.letters.create(
   description: "Test letter",
   to: to_address["id"],
   from: from_address["id"],

data/examples/list_postcards_metadata.rb

@@ -0,0 +1,94 @@
+$:.unshift File.expand_path("../lib", File.dirname(__FILE__))
+require 'lob.rb'
+require 'pp'
+
+# initialize Lob object
+lob = Lob::Client.new(api_key: 'YOUR_API_KEY')
+
+# HTML to send to the server
+html = %{
+<html>
+<head>
+<title>Lob.com Sample 4x6 Postcard Front</title>
+<style>
+  *, *:before, *:after {
+    -webkit-box-sizing: border-box;
+    -moz-box-sizing: border-box;
+    box-sizing: border-box;
+  }
+
+  @font-face {
+    font-family: 'Loved by the King';
+    font-style: normal;
+    font-weight: 400;
+    src: url('https://s3-us-west-2.amazonaws.com/public.lob.com/fonts/lovedByTheKing/LovedbytheKing.ttf') format('truetype');
+  }
+
+  body {
+    width: 6.25in;
+    height: 4.25in;
+    margin: 0;
+    padding: 0;
+    /* If using an image, the background image should have dimensions of 1875x1275 pixels. */
+    background-image: url('https://s3-us-west-2.amazonaws.com/public.lob.com/assets/beach.jpg');
+    background-size: 6.25in 4.25in;
+    background-repeat: no-repeat;
+  }
+
+  .text {
+    margin: 50px;
+    width: 400px;
+    font-family: 'Loved by the King';
+    font-size: 50px;
+    font-weight: 700;
+    color: white;
+    text-shadow: 3px 3px black;
+  }
+</style>
+</head>
+
+<body>
+  <h1 class="text">Hello {{name}}!</h1>
+  <p class="text">Join us for the {{event}}!</p>
+</body>
+
+</html>
+}
+
+# create a to address
+to_address = lob.addresses.create(
+  name: "ToAddress",
+  address_line1: "120 6th Ave",
+  address_city: "Boston",
+  address_state: "MA",
+  address_country: "US",
+  address_zip: 12345
+)
+
+# create a from address
+from_address = lob.addresses.create(
+  name: "FromAddress",
+  address_line1: "120 6th Ave",
+  address_city: "Boston",
+  address_state: "MA",
+  address_country: "US",
+  address_zip: 12345
+)
+
+# send a postcard
+pp lob.postcards.create(
+  description: "Beach Postcard",
+  to: to_address["id"],
+  from: from_address["id"],
+  metadata: { campaign: "Summer 2015 Beach" },
+  merge_variables: { name: "Albert", event: "Summer 2015 Beach-athon" },
+  front: html,
+  back: "<h1>Please RSVP as soon as possible to reserve your lounge chair.</h1>"
+)
+
+pp lob.postcards.list(
+    metadata: {
+      campaign: 'Summer 2015 Beach'
+    },
+    limit: 1
+)

data/examples/postcards.rb

@@ -1,8 +1,9 @@
 $:.unshift File.expand_path("../lib", File.dirname(__FILE__))
-require 'lob'
+require 'lob.rb'
+require 'pp'
 
 # initialize Lob object
-lob = Lob::Client.new(api_key: 'YOUR_API_KEY_HERE')
+lob = Lob::Client.new(api_key: 'YOUR_API_KEY')
 
 # HTML to send to the server
 html = %{
@@ -29,7 +30,7 @@ html = %{
     margin: 0;
     padding: 0;
     /* If using an image, the background image should have dimensions of 1875x1275 pixels. */
-    background-image: url(https://s3-us-west-2.amazonaws.com/public.lob.com/assets/beach.jpg);
+    background-image: url('https://s3-us-west-2.amazonaws.com/public.lob.com/assets/beach.jpg');
     background-size: 6.25in 4.25in;
     background-repeat: no-repeat;
   }
@@ -75,7 +76,7 @@ from_address = lob.addresses.create(
 )
 
 # send a postcard
-puts lob.postcards.create(
+pp lob.postcards.create(
   description: "Beach Postcard",
   to: to_address["id"],
   from: from_address["id"],

data/examples/postcards_idempotent.rb

@@ -0,0 +1,92 @@
+$:.unshift File.expand_path("../lib", File.dirname(__FILE__))
+require 'lob.rb'
+require 'pp'
+
+# initialize Lob object
+lob = Lob::Client.new(api_key: 'YOUR_API_KEY')
+
+# HTML to send to the server
+html = %{
+<html>
+<head>
+<title>Lob.com Sample 4x6 Postcard Front</title>
+<style>
+  *, *:before, *:after {
+    -webkit-box-sizing: border-box;
+    -moz-box-sizing: border-box;
+    box-sizing: border-box;
+  }
+
+  @font-face {
+    font-family: 'Loved by the King';
+    font-style: normal;
+    font-weight: 400;
+    src: url('https://s3-us-west-2.amazonaws.com/public.lob.com/fonts/lovedByTheKing/LovedbytheKing.ttf') format('truetype');
+  }
+
+  body {
+    width: 6.25in;
+    height: 4.25in;
+    margin: 0;
+    padding: 0;
+    /* If using an image, the background image should have dimensions of 1875x1275 pixels. */
+    background-image: url('https://s3-us-west-2.amazonaws.com/public.lob.com/assets/beach.jpg');
+    background-size: 6.25in 4.25in;
+    background-repeat: no-repeat;
+  }
+
+  .text {
+    margin: 50px;
+    width: 400px;
+    font-family: 'Loved by the King';
+    font-size: 50px;
+    font-weight: 700;
+    color: white;
+    text-shadow: 3px 3px black;
+  }
+</style>
+</head>
+
+<body>
+  <h1 class="text">Hello {{name}}!</h1>
+  <p class="text">Join us for the {{event}}!</p>
+</body>
+
+</html>
+}
+
+# create a to address
+to_address = lob.addresses.create(
+  name: "ToAddress",
+  address_line1: "120 6th Ave",
+  address_city: "Boston",
+  address_state: "MA",
+  address_country: "US",
+  address_zip: 12345
+)
+
+# create a from address
+from_address = lob.addresses.create(
+  name: "FromAddress",
+  address_line1: "120 6th Ave",
+  address_city: "Boston",
+  address_state: "MA",
+  address_country: "US",
+  address_zip: 12345
+)
+
+# send a postcard
+pp lob.postcards.create(
+  {
+    description: "Beach Postcard",
+    to: to_address["id"],
+    from: from_address["id"],
+    metadata: { campaign: "Summer 2015 Beach" },
+    merge_variables: { name: "Albert", event: "Summer 2015 Beach-athon" },
+    front: html,
+    back: "<h1>Please RSVP as soon as possible to reserve your lounge chair.</h1>"
+  },
+  {
+    'Idempotency-Key': '026e7634-24d7-486c-a0bb-4a17fd0eebc5'
+  }
+)