Contacts

A Contact is a host (talent) on your roster. It's the hub that ties together a person's platform connections, stats, statements, messages, and events.

The contact profile #

Each contact carries core fields (name, phone, email, date of birth, locale) plus custom fields you define. A contact can have per-platform details (ContactPlatformDetails) for TikTok and/or Bigo — each with its own status, platform ID, start date, assigned recruiter, and sub-agency.

Status pipeline #

Per-platform status moves through: Applied → Interviewed → Hired → Retired / Rejected. Status-based tags (e.g. tiktok:hired) sync automatically so you can segment on them.

Notes, tasks, and targets #

• Notes — freeform internal notes on the host.
• Tasks — to-dos tied to the contact, surfaced to staff.
• Monthly targets — a personal diamond goal per month; hitting it can trigger a goal achievement alert.

Tags #

Apply tags freely. Tags double as audience conditions in campaigns.

Spotting hosts who have gone quiet #

The Platform Details list — the per-platform records, nested under Contacts in the navigation — carries two columns you can switch on: Last active, the date of the most recent stat period for that host on that platform, and Days idle, how long it has been. An Inactivity filter narrows the list to everyone idle for at least a number of days you choose.

That is the same measure an inactivity rule uses, so you can see who a rule would hit before you let it run.

Importing contacts #

Import leads (CSV) on the contacts list creates contacts from a spreadsheet. Its Language column takes en, es or pt_BR, and also understands what spreadsheets usually hold instead: a code with a region, in any case (pt-BR, es-MX, en-GB), or the language's name in English, Spanish or Portuguese (Portuguese, Español, Inglês). Those are saved as en, es or pt_BR. Portuguese from any region, pt-PT included, is saved as pt_BR.

Any other value, such as fr, is saved as written so it is not lost. Messages to that host use the app's default language, and the host portal uses their browser's language if it is one of ours, until the host picks a language in the portal. An unrecognised value longer than 10 characters fails its row.

A Date of birth must be written YYYY-MM-DD, for example 2001-11-05. A time of day after it, written like 00:00:00 as some spreadsheets export it (2001-11-05 00:00:00), is ignored; a time in any other form, such as 2001-11-05 10:30, fails its row. A date written another way, such as 05/11/2001, fails its row. A date of birth that makes the host younger than 18 fails its row too, as it would on the contact form.

A row whose Email matches a contact this agency already has updates that contact rather than adding a second copy of them. A row with no email always creates a new contact, so two people with no email address on file stay two contacts.

The Import TikTok contacts and Import Bigo Live contacts buttons also take a Substatus column. Write the substatus's name as it appears under Settings → Substatuses; capitals don't count. See Substatuses.

If you see only some hosts, because you are in a sub-agency or you are a recruiter, the import matches emails only among the hosts you can see. A row whose email belongs to a host you can't see fails, and that host is not changed. The platform contact imports work the same way, and also fail a row when the host's account on that platform is one you can't see, such as one in another sub-agency. The event import matches host names only among the hosts you can see.

Bulk actions #

From the contacts table you can, in bulk: send WhatsApp, send email, attach tags, and export to CSV. There's also a merge tool to combine duplicate contacts (it moves messages, statements, events, conversations, and tags onto the surviving record). Two contacts that each have an account on the same platform can't be merged until you delete one of those two accounts.

Bulk send WhatsApp is WhatsApp bulk messaging, in the Pro and Agency plans. From 1 November 2026, on Starter the button is disabled and says why; Send WhatsApp on one contact still works. See Billing.

For a copy of everything rather than just the contacts table, see Exporting your data.

Deleting and restoring #

Deleting, permanently deleting and restoring a contact, erasing their personal data and merging contacts are for admins who are not attached to a sub-agency. A permission role, even one with Talent: Delete, doesn't include them.

Deleting contacts — one at a time or in bulk — is reversible. The confirmation dialog names how many records it will affect. A deleted contact's monthly statements, platform details, monthly targets, event participations and tasks are deleted with them, so they leave the statement and host lists. Statements already paid still count in revenue figures. Their points, reward requests and message history are left as they are. A deleted contact can't sign in to the host app.

To bring them back, set the table's Deleted records filter to Only deleted records and use Restore on the row, or restore a selection in bulk. Restoring brings back what was deleted with them. A statement you deleted on its own before that stays deleted.

When you generate monthly statements from imported stats, a contact deleted on or after the first day of that month still gets that month's statement, and it counts in your revenue figures. They aren't sent anything about it. A contact deleted before that month gets none, and neither does an archived contact or one whose personal data was erased, including by permanent deletion. You also can't create a statement by hand for a contact whose personal data was erased.

Permanent deletion sits in its own submenu under the bulk actions and asks you to type DELETE. It erases each contact's personal details and their edit history for good, and there is nothing left to restore afterwards. Monthly statements, payouts and the points ledger are kept as anonymous records, without the person's details, so your books stay complete.