You can send user data from your backend systems or third-party software to power your targeting, personalization, and measurement efforts. This provides richer targeting options for delivering relevant and engaging product Experiences.
There are three ways to get data into Chameleon: through integrations, via the API, or with CSV imports. This article helps you choose the right method for your team.
👉 Read about understanding data in Chameleon for a full overview of data in Chameleon
Choosing a method
Each method supports different data types and is suited to different workflows. You can use multiple methods at the same time.
Method | Best for | Sends User Properties | Sends Company Properties | Sends Events | Sends Tags |
Integrations (CDPs and connected tools) | Teams already collecting data in a CDP or analytics tool — automatic sync, no code changes | Yes | Yes (via Group calls) | Yes | No |
API | Developers who want real-time, programmatic control over what Chameleon receives | Yes | Yes | Yes | No |
CSV imports | One-time uploads, static lists, or non-technical teams who need data in Chameleon immediately | Yes | Yes | No | Yes |
Sending data via integrations
If you already use Twilio Segment or Freshpaint, this is the recommended way to send data to Chameleon. Enable the integration from your Dashboard and Chameleon will automatically receive all the user data you already collect — User Properties, Company Properties (via Group calls), and Events.
If you don't use these CDPs but do use one of Chameleon's data-source integrations — Amplitude, Mixpanel, HubSpot, Salesforce, and others — you can pull data into Chameleon from those tools.
You can also send enriched data from your entire tool stack with Hightouch or Census.
👉 Read about how to integrate Chameleon with your tool stack for the full list of supported integrations and setup guides.
💡 Integrations are the easiest method to keep your data in sync — once connected, new data flows automatically without manual effort.
Sending data via the API
You can send User Properties, Company Properties, and Events directly to Chameleon using our API.
To learn more about this please visit the following articles:
🧑💻 Developers can help: ask your technical teammates to set up data sending if you're not comfortable doing it alone. You only need to do this once — gather the list of user data you want to use in your Segments and ask your developers to send it all.
Sending data via CSV imports
CSV imports let you upload a spreadsheet from the Dashboard to either tag users or update properties. This is the best option when you need to get data into Chameleon quickly, without developer resources, or when working with a one-time list.
CSV imports support:
Tagging users or companies: Add a Tag to users or companies provided in your file, which you can then use as a filter when creating Segments
Updating User Properties or Company Properties: Map columns in your CSV to properties in Chameleon, creating new properties or updating existing ones
ℹ️ CSV imports create static data. If your data changes frequently, consider using integrations or the API for automatic syncing.
👉 Read about how to import data with CSV files for the step-by-step process.
Sending data via webhooks
Webhooks provide a way to send data to Chameleon from any external tool or system that supports outgoing webhooks. This method directly updates User Properties, Company Properties, or Events and enables real-time synchronization between Chameleon and tools that aren't covered by native integrations.
👉 Read about creating custom integrations with Webhooks.
What happens after I send my data?
Once data arrives in Chameleon, it becomes available across the platform:
User Properties and Company Properties are available immediately for use in Segments, Personalization, and dynamic URLs
Tracked Events are processed and added to user profiles within 5 minutes (Events sent via JavaScript have no delay)
Untracked Events are accepted and processed for property categorization, but not saved to user profiles
Tags are available immediately as Segment filters
All data appears on the Data Management page in your Dashboard, where you can review, rename, and organize it
ℹ️ When sending data to Chameleon, null-valued properties will not be sent and are removed as a matter of cleanup and consistency.
👉 Read about managing your data in Chameleon to learn how to organize your properties and events after importing.