# Sub-accounts

{% embed url="<https://www.loom.com/share/c194ec674b5f4b28b1b446ee3b2c77be>" %}
Sub-accounts video tutorial
{% endembed %}

{% embed url="<https://app.arcade.software/share/wpdvHyLK6c5XAEDCVB3U>" %}
Try how it works
{% endembed %}

> **Boomerangme > Left-Hand Menu > Agency**

1. Follow the workflow mentioned above to land on the Agency screen.<br>
2. From the bottom of the page, click the Sub-Accounts icon ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXc6qHzkWGhRXfWgrLptnFcoJHgXigAeHJa1xr4yQs7jRgXn4JXHVtBSKy4cdrw9T0IJo8mwcoQTiP8MJpaf-SY8ykKL1OWB7xUS09nODtm1MmO1yblm3ZQM5jP9LLYO1QE9X9RC?key=fJn0LUwY9X6-UsGk79bbOr0A) or the subaccounts tab . Doing so takes you to the Sub-Accounts screen.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FvRxyfePUih74KdYJzzhv%2Fimage.png?alt=media&#x26;token=a5f661d3-6796-4187-817d-37a8a2835d6d" alt=""><figcaption><p>Sub-Accounts</p></figcaption></figure>

3. Here, the stats for sub-accounts are displayed via four tiles that include Total sub-accounts, Paid sub-accounts, Unpaid sub-accounts, and Trial sub-accounts.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FEFiFgL4aoNvDiVXNAbtQ%2Fimage.png?alt=media&#x26;token=12a9887f-ffba-4ea5-99c8-0f55248d60c1" alt=""><figcaption><p>Sub-accounts</p></figcaption></figure>

4. At the top right corner, you will find the export button. This button allows you to export your sub-accounts list with all the information of your sub-accounts. Once you click on this tab, a list would be downloaded which contains your sub-accounts data.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2Fo9SH2caCWjIYivKdRSbQ%2Fimage.png?alt=media&#x26;token=04029df5-b8a6-4737-8f80-b5ef10f1bb27" alt=""><figcaption></figcaption></figure>

5. In this section, you can view your subscription usage, the number of subaccounts currently active, and the upcoming invoice for additional subaccounts (if you’ve exceeded the three free subaccounts included in your plan and don’t have an Unlimited subscription).&#x20;

**Billing for subaccounts is calculated automatically:**

* Each billing cycle, the system checks how many subaccounts had the “Paid” status at any time during that period.
* For every additional “Paid” subaccount beyond your 3 free ones, a $15/month charge applies.
* Subaccounts marked as “Trial” or “Unpaid” are not billed.

You can also view your current subaccount usage and track all payments and invoices in the Current Usage and Upcoming Invoice tabs.

From the last tab, you can modify or cancel your subscription at any time.

A subaccount changes its status to “Paid” only in cases:

💼 **The agency manually extends the subaccount’s validity period or changes its plan** from the agency dashboard.

This can be done under **Agency → Subaccounts → Edit plan**.\
When the agency manually sets a new expiration date that is later than the current one, the subaccount automatically receives the **“Paid”** status.

💡 **Additional Notes:**

* If a subaccount has been marked as **“Paid”** even for a short period during the current month, it will be **included in the billing for that period**.
* In the following month, no charge will apply if the subaccount’s status is changed back to **“Trial”** or **“Unpaid”** before the next billing cycle begins.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FWkAuHjPOyofsQrlFZq28%2Fimage.png?alt=media&#x26;token=8b77ebc7-a959-4528-8405-fb6a7ff6a6e0" alt=""><figcaption></figcaption></figure>

6. On the next tabs, you can filter your subaccounts list based on the subaccount status (Paid, Unpaid, Trial, Deleted)

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2F7jOpchSY8qYSRxfzCQcw%2Fimage.png?alt=media&#x26;token=87ebab05-731b-48ce-8b7d-36b09e7ce799" alt=""><figcaption><p>the subaccount status</p></figcaption></figure>

* **Unpaid Subaccounts** refers to subaccounts that have completed the free trial period and have not made any payment to continue usage, these subaccounts are usually blocked.<br>
* **Paid Subaccounts** refer to subaccounts that have either made payments to continue usage or have had their payment dates or plan manually changed from the change plan tab. \
  ✅It is very important to remember that if the change plan button is tampered with, the system will automatically mark that subaccount as paid whether payment was actually received or not. What this implies is that, when the system marks the subaccount as paid, if it exceeds the limit of free subaccounts, you will be charged.<br>
* **Trial Subaccounts** refer to subaccounts on trial, this could mean that the subaccount recently signed up for the 14days trial and it could also mean that the 14days trial was reset for this subaccount after the subaccount completed the initial 14days trial. \
  ✅The agency has the opportunity to reset the trial period for each subaccount once after the subaccount has completed the initial 14days trial. A restart trial button usually appears 24 hours after the initial 14days trial has been completed.&#x20;

7. Next we have the actions tab and the search bar. **The actions tab** allows you to complete different actions such as adding subaccounts, deleting subaccounts, applying snapshots to subaccounts and exporting snapshots from subaccounts.\
   **The search bar** gives you the opportunity to search for subaccounts through the subaccount name, email, phone number or company ID.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2F1ZGym3ONJhc7iXn1uJnd%2Fimage.png?alt=media&#x26;token=1c5ec6ac-8c3c-486a-aae7-8b2128fa031a" alt=""><figcaption><p>the actions tab and the search bar</p></figcaption></figure>

8. This is followed by the existing sub-accounts tabulated. Information is presented via various columns that include User Name, Actions, Registration Date, Plans, Status.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FpkTPvYCW290y388uR5Ad%2Fimage.png?alt=media&#x26;token=0f6af3f2-fe63-4d16-9a99-2378dcc06541" alt=""><figcaption><p>Sub Accounts tabulated</p></figcaption></figure>

9. To add a sub-account, click the actions tab and click on the Add sub-account button at the top of the list. This opens the Create Sub-Account popup. \
   ✅If the add subaccount button is greyed out, you need to check your domain, if your domain is connected correctly or if your domain has expired.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FIiKlob7notn62DKvGLnY%2Fimage.png?alt=media&#x26;token=2ba3a7db-b44b-41db-9c4b-3fca8d2caa85" alt=""><figcaption><p>Manually adding a sub-account</p></figcaption></figure>

7. Here, use the First Name field to enter the first name for the sub-account.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FbUD3WIbFiOBGhXNO1Dai%2Fimage.png?alt=media&#x26;token=fda40dba-4ccf-4bbd-8ac4-674e41c3ad53" alt=""><figcaption><p>First Name</p></figcaption></figure>

8. Enter the last name in the Last Name field.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2Fnk1r1vTY5QBqHjnNwW5i%2Fimage.png?alt=media&#x26;token=a3e5052a-b715-44a4-9aa1-8870deb04c5d" alt=""><figcaption><p>Last Name</p></figcaption></figure>

9. Enter the organization name in the Company Name field.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FukOh58R55ex3T2PYTJxo%2Fimage.png?alt=media&#x26;token=962e90f6-abf1-4a87-8186-e955bcd9282b" alt=""><figcaption><p>Company Name</p></figcaption></figure>

10. Use the Contact Number field to record the contact number.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FDhsqS9vLY2ELtpq1agz8%2Fimage.png?alt=media&#x26;token=9b7889a1-2b5e-48ba-9100-6898921ea3fb" alt=""><figcaption><p>Contact Number</p></figcaption></figure>

11. Enter the email address in the Email field.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FQZDB19qUaEXkmE0C36pi%2Fimage.png?alt=media&#x26;token=13b22cfe-e1e9-4d70-bc4b-ae5afc5553db" alt=""><figcaption><p>Email</p></figcaption></figure>

12. Use the password to create a password.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FYeWrP1SZGmZkCIrZdIvf%2Fimage.png?alt=media&#x26;token=bc6aeb92-ed8f-4f6e-97e0-756e6441199f" alt=""><figcaption><p>Password</p></figcaption></figure>

13. Use the Repeat Password to re-enter your set password for confirmation.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FVYV1kvAwePn29qTuNgYS%2Fimage.png?alt=media&#x26;token=d52c65aa-eef4-4ed7-8a7a-328a7a6b9f33" alt=""><figcaption><p>Repeat Password</p></figcaption></figure>

14. Use the dropdowns under Plan heading to set the payment frequency. The first dropdown includes the First, Second, and Third options whereas the second dropdown includes Month, Quarter, and Year. Selecting First and Month means the payment processing will be done during the first month.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FooDYJqLxv6XnIwEckvMg%2Fimage.png?alt=media&#x26;token=ef46e9e5-95d3-42c7-b01a-cf9958166d80" alt=""><figcaption><p>Plan</p></figcaption></figure>

15. Use The plan expiration date calendar to set the date of expiry for the plan.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2Fo7ALVldZ7eYAVwn9eROE%2Fimage.png?alt=media&#x26;token=f6e85c0d-9e32-4ccb-9b1f-03c1b10634c0" alt=""><figcaption><p>Plan Expiration Date</p></figcaption></figure>

16. In case you want to edit prices, enable the Edit Prices toggle button.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FpNwb0u7uv4iSIYjxTjcd%2Fimage.png?alt=media&#x26;token=dd9e6178-6da8-439f-924a-f6c05a58e9a5" alt=""><figcaption><p>Edit Prices</p></figcaption></figure>

17. This reveals additional fields that let you define the monthly cost for each time duration (year, quarter, month).

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FMAO4tmrc99R0Tth6nUOP%2Fimage.png?alt=media&#x26;token=7b3a8fb5-c665-40e1-bcad-2a751571a92b" alt=""><figcaption><p>Prices</p></figcaption></figure>

18. Once the selections are made, click the Add button. This adds the sub-account and lists it in the table.

### **How to Switch Between Sub-Accounts**

You can switch between sub-accounts without returning to the agency account. After switching to a sub-account, you can move between other sub-accounts directly from there, without going back to the agency view.

<figure><img src="https://121681468-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBfW4nnOu4AysbkbyxNug%2Fuploads%2FC5rtcDXfDPEr0ElwvyzM%2Fimage.png?alt=media&#x26;token=1a1ce789-8704-483b-9625-005cd412ee97" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://docs.boomerangme.cards/agency-account/sub-accounts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
