# Import Custom Actions

Everything that falls outside of website actions should be imported using the Custom Actions import type.

Most common examples are trial data for PLG customers or product analytics data that HockeyStack does not currently integrate with.

### Example Schema

All column names should be in underscores.

<table data-full-width="true"><thead><tr><th width="186.80859375">Column Name</th><th width="239.0234375">Example Value</th><th>Requirement<select><option value="FCwedFAQ5YXx" label="required" color="blue"></option><option value="YB08Mb3gZejz" label="recommended" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td>action_name</td><td>Newsletter Engagement</td><td><span data-option="FCwedFAQ5YXx">required</span></td><td>The name of the action. If none is provided, this will be deduced from your table / dataset name</td></tr><tr><td>identity</td><td>person@company.com</td><td><span data-option="FCwedFAQ5YXx">required</span></td><td>Identifier column. email address or company domain</td></tr><tr><td>date</td><td>2025-03-18T12:58:01.000Z</td><td><span data-option="FCwedFAQ5YXx">required</span></td><td>The timestamp of the custom action</td></tr><tr><td>user_id</td><td>684748833</td><td><span data-option="YB08Mb3gZejz">recommended</span></td><td>Contact or company id from CRM or other sources. provides additional identifier information</td></tr><tr><td>company_domain</td><td>company.com</td><td></td><td>This will be saved as a company property</td></tr><tr><td>company_name</td><td>Awesome Company</td><td></td><td>This will be saved as a company property</td></tr><tr><td>engagement_type</td><td>Direct</td><td></td><td>This will be saved as an action property</td></tr><tr><td>is_returning_user</td><td>False</td><td></td><td>This will be saved as an action property</td></tr><tr><td>email_opened_at</td><td>1735689600000</td><td></td><td>This will be saved as an action property</td></tr><tr><td>email_scheduled</td><td>True</td><td></td><td>This will be saved as an action property</td></tr><tr><td>contact_name</td><td>Someone Everyone</td><td></td><td>This will be saved as an action property</td></tr></tbody></table>

### Optional Schema (non-required columns):&#x20;

Having extra columns help better connect and enrich your data within HockeyStack. Column names are expected to align with our formatting guidelines for import to work properly.

### Action Properties and Other Properties:&#x20;

You can specify object-specific data by prefixing it with the hardcoded object type:

* `company_`  to specify a company property&#x20;

Other columns within your table that do not fit the example schema provided will be included as action properties in the import.&#x20;