> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/integration-setup-guides/tools-and-productivity/smarty-integration.md).

# Smarty Integration

Order Desk can use [Smarty](https://smartystreets.com/) (formerly known as SmartyStreets) to validate your shipping addresses and store important order metadata such as time zone and latitude/longitude.

### Setup

To connect to Smarty from Order Desk, click on **Manage Integrations** in the left sidebar. Under the **Productivity** tab, look for and enable Smarty.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FfNMuBDoV2p47P6QH9mL2%2Flegacy-0be015c40d66a7260168.png?alt=media)

Alternatively, search for Smarty from the available integrations search.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FmIATZ7CyUyCZLwRanaGI%2Flegacy-86572920f635790e0ac9.jpg?alt=media)

Enter your Smarty API key and token into the Order Desk integration page, then click **Connect to Smarty**.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FFJgW4XCFjh13koU4C52w%2Flegacy-6235c6c810c228a518d6.png?alt=media)

### Integration Settings

After entering your API Key, you’ll be able to set a few settings for your Smarty integration.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FfAZdLd4QhBQSzOhctEHw%2Flegacy-a10ab7a563bc38327644.png?alt=media)

#### Automatically Process Orders on Import

Selecting this will automatically process and fix addresses as orders import. When enabled, use a rule with events for **After Addresses Successfully Validated with Smarty** and **After Address Failed to Validate with Smarty** to take action on these orders, such as submitting to a fulfillment integration or moving to a folder for review.

If left unchecked, you’ll need to either manually validate each address or set up a rule to validate addresses automatically on the event of your choosing.

Read more under the [How to Validate Addresses section](#how-to-validate-addresses).

#### Save Zip+4

Select to include the additional 4 number extension to be used on US zip codes.

#### Save Extra Metadata

Store extra data about the address in the metadata for the order.

#### Enable International Processing

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FVrJL2xovZt3VKWnGzNGW%2Flegacy-87880b93a21e30b8262b.png?alt=media)

Select to enable the option to validate international addresses. When enabled, you’ll have several options to choose for how strict you want validation to be when evaluating addresses.

### How to Validate Addresses

#### Using Rules to Validate Addresses

You can use rules in the [Rule Builder](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md) to check and fix addresses automatically at the event you choose, for instance when orders move into a certain folder.

Make a new **Order Rule,** then choose the event that will trigger the rule to run on orders, for example **When Folder is Changed**.

Set any filters you want to apply, then under Actions select **Validate Address With Smarty**. Name your rule, save and enable it to apply to all future orders that apply to this rule.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FswTXtNDQNsCevXfwbEoe%2Flegacy-17fc626108adab2c4d30.png?alt=media)

For more information on setting up rules, see the [How to Work with Rules](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md) guide.

#### Manual Validation

If you don’t have the integration set up to automatically validate addresses and you haven’t set up rules to do so, you can manually go into any order and validate an address by clicking on the **Not Validated Yet** button.

Order Desk will attempt to validate the address for you and return the results. If more than one valid result exists, they will all be displayed and you may choose one. The status will change to **Address Validated**.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FpRGVaAlyM66wFJgaorze%2Flegacy-e5f85f5d7e4d6937c97e.gif?alt=media)

#### If Address is Invalid

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FwR1IhmCPbxTo1nBpZ6nE%2Flegacy-9d3e112ff0d7c666cea9.png?alt=media)

If the validation does not pass, you’ll get a message that the address is invalid. This means the address is incorrect and cannot be validated. Use the event **After Address Failed to Validate with Smarty** to [setup a rule](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md) and take action on the order, like move it to a folder for review or send a notification email to a store admin. You may want to reach out to your customer to verify their correct address.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.orderdesk.com/integration-setup-guides/tools-and-productivity/smarty-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.