> For the complete documentation index, see [llms.txt](https://help.smartrr.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartrr.com/docs/support/integrations/blueprint-x-smartrr-integration.md).

# Blueprint x Smartrr Integration

The Blueprint x Smartrr integration allows customers to manage their subscriptions via SMS.

Smartrr's integration with Blueprint works by sending automated SMS for upcoming subscriptions, subscription confirmation, and post-order check-ins. These messages can be used for the following use cases:&#x20;

* Welcoming new subscribers
* Letting a subscriber know when their next shipment is upcoming
* Allowing customers to SKIP or DELAY via SMS response
* Resolving issues with delayed shipments or product questions

## Setup

First, you'll need to generate a unique access token in the Smartrr App for Blueprint. Log into your Smartrr admin and navigate to **Integrations**. Under the **API Keys** tab, select **Create Key**.

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Fi5nvNdtRZlOVXQbAzu3Y%2Fadd-api-key.png?alt=media&amp;token=9b38a9d3-1359-45f3-9f22-93854ae6fd8a" alt="Steps highlighted to create an API Key in the Smartrr admin app"><figcaption></figcaption></figure>

We suggest naming your Token Nickname and Application Nickname "Blueprint". Before creating, ensure you change the permissions for Subscriptions, Customers, and Webhooks from Read to **Read and Write**. Press **Create** and then copy your newly created key.&#x20;

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FOhgQudqgWDq1eoB2DnjU%2Fcreate-api-key-read-write.png?alt=media&amp;token=23fdbfb7-dd82-4044-a822-87fac9a0c263" alt="Minimum permissions required for the Smartrr API Public Key for integration with BluePrint"><figcaption></figcaption></figure>

In your Blueprint admin, navigate to your Integrations Hub and click **Smartrr Subscriptions**.

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FCRZY6U70T4F3PQ5eMN1M%2FFrame%203.png?alt=media&amp;token=9f6e608a-0fc6-4cad-ab8c-6a06fa014dae" alt="Option highlighted in the Blueprint admin app to integrate with Smartrr"><figcaption></figcaption></figure>

Paste your copied key from the Smartrr Admin into the field labeled **Smartrr Access Token**. Click **Test connection** and wait for the green tick to appear. Next, click **Activate** to complete integration setup.

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FuGtwUEelz45HpUaYq5OZ%2Fimage-png-Oct-25-2021-09-20-06-68-AM.png?alt=media&amp;token=a0f1f9fb-c4f3-4bd7-97b9-1d8670cd80e8" alt="Example of a Smartrr Access token configured in the BluePrint admin app"><figcaption></figcaption></figure>

## SMS Subscription Management

To set up some of the use cases discussed at the beginning of this article, navigate to the Automatics section of your Blueprint admin. Toggle live (or create) the relevant subscription automations.&#x20;

* [New Subscription](https://help.blueprint.store/create-a-subscription)
* [New Subscription Check-in (1st order only)](https://help.blueprint.store/create-a-subscription-post-order-check-in)
* [Upcoming Charge](https://help.blueprint.store/create-an-order-confirmation-message)
* [Recurring Charge Confirmation](https://help.blueprint.store/create-a-recurring-charge)

{% hint style="info" %}
**Note:** By default, Smartrr sends upcoming subscription charge messages 3 days before the upcoming charge. Currently, this time frame can't be change. &#x20;
{% endhint %}

❓ Have more questions about Blueprint? Check out their [<mark style="color:blue;">Help Center</mark>](https://help.blueprint.store/).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.smartrr.com/docs/support/integrations/blueprint-x-smartrr-integration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
