Add your existing consent

If you already hold consent from people, for example a signed-up list, you can record it from the agent's Consent tab so the app can message them. The Record Existing Consent tile (titled Import Contact Consent in the app) takes one number at a time, and Import CSV takes up to 10,000. You can opt numbers in or out. This sends no message. The app writes the result to the contact's consent properties. The app does not check where your consent came from, so record only consent you actually hold. For the carrier compliance review, see launch your RCS Studio agent.

Access

You do not need an RCS Studio account to record consent. Opting contacts in and out, one at a time or in bulk, needs the manual consent switch. It is under Consent management in HubSpot actions on the Settings page and is off by default, so only a HubSpot super admin can use it until a super admin turns it on (Manage your team in HubSpot). The Consent tab opens for anyone with See links, the manual consent switch or the API consent switch, but the tile and import window need the manual consent switch.

Without the manual consent switch, the tile and the import window do not appear. The same switch lets you see recent imports, cancel one and use the re-opt-in checkbox.

Record one number

  1. Open the agent's Consent tab, Record Existing Consent tile.
  2. Enter the Phone number. Accepted formats are E.164 (+12345550100), a 10-digit US number, or an 11-digit number starting with 1. Anything else shows "Enter a phone number in E.164 format (+12345550100) or 10-digit US format". The server also rejects numbers that only look valid, such as a 555 area code.
  3. Choose Opt in or Opt out.
  4. For an opt-in you can also enter a First name (optional) and a Last name (optional). They are saved only if the contact has no first or last name yet.
  5. Select Submit. The result shows under the button, for example "+12345550100 opted in." If HubSpot could not save a name it adds "The name could not be saved." The opt-in is still recorded.
  • Opt in creates a HubSpot contact if no contact has that number, and writes the consent properties. The timeline entry shows How as Manual entry.
  • Opt out on a number no contact has records nothing, though the screen still reports it as opted out.
  • If the tester invite fails on an agent that has not launched, the opt-in fails too ("Submission failed. Please try again.").

Contacts who opted out

An import never silently undoes a STOP. A number whose contact has opted out of this agent is skipped. For one number the tile says "+12345550100 opted out of this agent on 2026-01-31. Tick "Allow re-opt-in of contacts who previously opted out" and submit again only if you hold new consent from them."

To opt them in anyway, tick Allow re-opt-in of contacts who previously opted out (off by default) when you submit or import. Each override is recorded in the consent history as "Manual entry (re-opt-in override)" or "CSV import (re-opt-in override)". No tester invite goes to a number skipped as opted out.

Import a CSV

Select Import CSV. A window opens with an Opt-in tab and an Opt-out tab.

File rules:

  • Start with a header row. The phone column is required. These columns are optional: first_name, last_name, email, company and job_title. Download template gives consent_import_template.csv with all six columns and an example row. The columns can be in any order.
  • Column names must match exactly, ignoring capitals and spaces. A file with any other column is refused before anything is imported, and the window names it, for example "Unrecognized column: company_name. Allowed columns: phone, first_name, last_name, email, company, job_title." A name used twice, or a column with no name between two named columns, is refused too. A blank column at the end of the header row, which spreadsheet exports often add, is ignored.
  • A detail cell can hold up to 255 characters. A longer one makes that row skipped, with the reason value_too_long. Shorten it and import the row again.
  • Empty cells are fine. A cell with a value fills that field on the contact only if the field is empty there. Existing values are never replaced. A contact the import creates gets every value. The Opt-out tab accepts the same columns and ignores all but the phone ("Columns other than phone are not used when opting out.").
  • You can upload the failed-rows file you download from the results again as it is: its row and reason columns are ignored.
  • Numbers can be E.164, 10-digit, or 11-digit US.
  • The file can be up to 10 MB ("File too large (max 10 MB). Please split into smaller files.") and 10,000 rows ("Up to 10,000 rows per import. Split larger files."). Blank lines are ignored.
  • Duplicate numbers are dropped silently, and the preview says "N duplicates removed". Rows with an invalid format are listed in the preview ("will be skipped") and are not imported.
  • The agent must be deployed. Otherwise the import is refused with "This agent is not deployed, so testers cannot be invited and opt-ins cannot be delivered." followed by the support address.

The preview shows how many numbers are ready. Select Import as Opted In or Import as Opted Out. For each number:

  • An opt-in creates a contact if none exists.
  • An opt-out reports the number as skipped when no contact has it. An opt-out of a contact that exists is recorded even if the contact was never opted in.

Results

If the agent is in Test Mode, an opt-in also sends the number a tester invite, and the person must accept it before the agent can reach them. See Test Mode and test devices.

Imports run in the background, so you can close the window. Time estimates are not published: speed depends on HubSpot's rate limits, and a rate-limited row is retried after 1, 2 and 4 seconds before it fails. The window shows "Processing N of M" with a progress bar and "imported, skipped, failed" counts, then the final counts. Show details and Hide details open the table of failed rows. Recent imports on the Consent tab lists the latest 10 for the agent (3 shown, then Show {N} more and Show less), with View for each. Results are kept 30 days.

StatusMeaning
QueuedWaiting to start. One import runs at a time per HubSpot portal, so a second import waits for the first.
RunningRows are being processed.
CancellingYou selected Cancel import. Rows not yet processed will not run, and rows already processed are not reverted.
CancelledEnded by a cancel.
CompletedAll rows processed. Some may be skipped or failed.
FailedStopped after repeated errors on one batch. Rows processed before then stay applied, and the rest were not applied. Contact support if it keeps happening.
StalledRunning, but no progress for 15 minutes. "Contact support if it does not resume." Cancelling a stalled import ends it.

Download rows that need attention gives rows_that_need_attention.csv with the columns phone,row,reason. The phone is first so you can upload the file again as it is. Row is the line number in your file, where the header is row 1.

ReasonMeaning
missing_phoneThe phone cell was empty.
invalid_phoneNot a valid number.
value_too_longA detail cell, such as the company, has more than 255 characters. The row is skipped.
opted out on <date>The contact opted out earlier and the re-opt-in checkbox was off.
consent_not_recordedHubSpot did not accept the consent update, for example under a rate limit. Import the row again.
timed_outThe batch ran out of time before the row started. Import it again.
imported, but <fields> not savedThe opt-in is recorded, but HubSpot refused those details. Usually it is an email that another contact already uses. Fix them in HubSpot.
already opted in, but <fields> not savedThe number was already opted in, and HubSpot refused those details.
Other textThe error message for that row.

When HubSpot refuses a detail the opt-in is still recorded. The results then say "N rows imported, but some details were not saved", and the rows appear in the download. They are not counted as failed.

Skipped rows, which are not failures, are numbers already opted in, opted-out contacts you did not override, and, for an opt-out import, numbers that were not opted in or have no contact. For an import that sent tester invites, the window says how many ("N tester invites sent: recipients must tap "Make me a tester" in the RBM Tester Management message before this agent can reach them.").

Troubleshooting

SymptomCauseFix
Import refused, "not deployed"The agent is not deployed in RCS Studio (Created, Updating or Setup Failed)Contact support.
Import stays QueuedAnother import for your account is runningWait, or cancel the other one.

Next


Did this page help you?