Import contacts into Nitrosend from inline records or CSV. Handles email opt-in, SMS TCPA compliance, list assignment, and tagging. Use when: "import contacts", "add subscribers", "upload contacts", "add to list", "bulk add contacts", or "import CSV".
Import Contacts
Help the user import contacts into Nitrosend.
Understand the Source
Ask where contacts are coming from:
- Inline records: User provides names/emails directly (up to 100 at a time)
- CSV file: Upload a local CSV through the direct-upload path (below)
- One by one: Use
nitro_manage_audiencewithoperation: "create_contact"for individual contacts
CSV Import (direct upload)
For a local CSV, nitro_import_contacts runs a three-step upload:
- Call it with
upload: {filename, content_type, byte_size, checksum}to reserve an authorized upload link - PUT the file bytes to the returned
direct_upload.url, sending exactly the returneddirect_upload.headers - Call
nitro_import_contactsagain with the returnedsigned_id(plus acolumnsmapping) to finalize; an existingimport_idcan also be processed
Large CSVs use the same async pipeline as the app/API/CLI: up to 250k rows
self-serve, sends held for review above 20k rows, larger files return
contact_sales.
Inline Import (< 100 contacts)
Use nitro_import_contacts with records array:
{
"records": [
{ "email": "alice@example.com", "first_name": "Alice", "last_name": "Smith" },
{ "email": "bob@example.com", "first_name": "Bob", "source": "product-webinar" }
]
}
Important Rules
- Email contacts: New contacts are auto-subscribed by default; existing
contacts keep their current subscription state unless
opt_inis explicit - SMS contacts: Must explicitly set
opt_in: true(TCPA compliance) - Both channels: Include both
emailandphonefields - Source tracking: Set
sourceto track where contacts came from
Always offer dry_run: true first to preview.
After Import
Add to a List
Use nitro_manage_audience with operation: "manage_list":
- Create a list:
action: "create",name: "List Name" - Add contacts:
action: "add_contacts",list_id,emails: [...]orcontact_ids: [...]
Tag Contacts
Use nitro_manage_audience with operation: "bulk_tag":
contact_ids: [...]tags: ["webinar-attendee", "product-interest"]tag_action: "add"(default),"remove", or"set"
Compliance Reminders
- Only import contacts who have given consent to receive emails
- Never import purchased or scraped lists
- Include a source identifier for audit trails
- SMS contacts require explicit written consent (TCPA)
- GDPR: Ensure lawful basis for EU contacts
Related skills
- Downloads
- Security audit
- Pass
- Last updated
- 3w ago
- Current version
- v1.0.0
- License
- MIT-0
