Wiresk

Wiresk

HubSpot CRM – Files, Workflows, Events

Estimated reading time: 13 min

What your automation will do…

A connection to your HubSpot account is needed so we can sync it with our platform.
Refer to HubSpot CRM – connection.
You can include between 1 and 255 Methods to build complex Flows.
HUBSPOT HubSpot CRM - Files, Workflows, Events

HubSpot’s File Manager is a centralized storage tool on the platform that assists users in managing and organizing different files, such as images, documents, and assets utilized in marketing, sales, and service tasks. It is particularly beneficial for storing assets such as logos, PDFs, and videos for marketing efforts, blogs, and landing pages.
 
Use Wiresk to automate file handling, such as:

  • Automatically creating folders when a new project or campaign is initiated.
  • Uploading and organizing assets directly from Flows.
  • Retrieving and using stored assets in marketing emails, landing pages, or social media posts.
Search through files in the file manager. Does not display hidden or archived files.
 
See HubSpot doc.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*Search for Files
Connection*Select your connection or create one
Map Fields [+Add Field] choose additional fields for the search:
Path, Parent Folder ID, Create at, Created at Lte, Updated at Lte, Updated at Gte, Size, Size Lte, Size Gte, Heigh, Heigh Lte, Heigh Gte, Width, Width Lte, Width Gte, Encoding, Type, Extension, URL, Is usable in Content, Properties to retrieve.
NameSearch for files containing the given name.
LimitNumber of items to return. Default limit is 10, maximum limit is 100.
If Not Found Consider asSuccess – When Record ID is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.
Additional Fields
PathSearch files by path.
Parent Folder IDSearch files within given folderId.

[⊕ Element][⊕ Map] Add more fields or Map it from a Data Source. See Field Mapping.

IDs: Unique identifier of the Parent Folder
IDsSearch by a list of file IDs.
ID LteSearch files by less than or equal to IDs. Can be used with ID Gte to create a range.
ID GteSearch files by greater than or equal to IDs. Can be used with ID Lte to create a range.
Expired atSearch files by exact expires time.
Expired at LteSearch files by less than or equal to expires time. Can be used with expires At Gte to create a range.
Expired at GteSearch files by greater than or equal to expires time. Can be used with expires At Lte to create a range.
Create atSearch files by time of creation.
Created at LteSearch files by less than or equal to time of creation. Can be used with created At Gte to create a range.
Created at GteSearch files by greater than or equal to time of creation. Can be used with created At Lte to create a range.
Updated atSearch files by time of latest updated.
Updated at LteSearch files by less than or equal to time of latest update. Can be used with updated At Gte to create a range.
Updated at GteSearch files by greater than or equal to time of latest update. Can be used with updated At Lte to create a range.
SizeSearch files by exact file size in bytes.
Size LteSearch files by less than or equal to file size. Can be used with size Gte to create a range.
Size GteSearch files by greater than or equal to file size. Can be used with size Lte to create a range.
HeighSearch files by height of image or video.
Heigh LteSearch files by less than or equal to height of image or video. Can be used with height Gte to create a range.
Heigh GteSearch files by greater than or equal to height of image or video. Can be used with height Lte to create a range.
WidthSearch files by width of image or video.
Width LteSearch files by less than or equal to width of image or video. Can be used with width Gte to create a range.
Width GteSearch files by greater than or equal to width of image or video. Can be used with width Lte to create a range.
EncodingSearch files by specified encoding.
TypeFilter by provided file type.
ExtensionSearch files by given extension.
URLSearch by file URL.
Is usable in ContentIf true, shows files that have been marked to be used in new content. If false, shows files that should not be used in new content.
SortSort files by a given field.

[⊕ Element][⊕ Map] Add more fields or Map it from a Data Source. See Field Mapping.

Field name
Properties to retrieveThis parameter allows you to specify which properties of the file you want to search for.

[⊕ Element][⊕ Map] Add more fields or Map it from a Data Source. See Field Mapping.

Field name
For example, if you’re searching a file, you might specify properties like “extension”, “type”, and “name”. Property Fields that do not exist will be skipped.

(*) required field


  },
  "results": [
    {
      "extension": "string",
      "access": "PUBLIC_INDEXABLE",
      "parentFolderId": "string",
      "encoding": "string",
      "type": "string",
      "isUsableInContent": true,
      "url": "string",
      "expiresAt": 0,
      "createdAt": "2025-01-20T08:26:38.817Z",
      "archivedAt": "2025-01-20T08:26:38.817Z",
      "archived": true,
      "path": "string",
      "size": 0,
      "name": "string",
      "width": 0,
      "id": "string",
      "defaultHostingUrl": "string",
      "updatedAt": "2025-01-20T08:26:38.817Z",
      "height": 0
    }
  ]
}
This Method will return the file with details such as name, height and width, encoding, the URL, and more by using the File ID.
If a file is set to private, the returned URL will result in an error.
 
See HubSpot doc.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*Get File
Connection*Select your connection or create one
Map Fields
File ID*  In the default value field, select the specific file you want to retrieve information from within a dynamic list of available files in your HubSpot database.

Or map it from a step response. refer to Mapping methods.
If Not Found, Consider as*: Failed or successSuccess – When File ID is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.
{
"extension": "string",
"access": "PUBLIC_INDEXABLE",
"parentFolderId": "string",
"encoding": "string",
"type": "string",
"isUsableInContent": true,
"url": "string",
"expiresAt": 0,
"createdAt": "2025-01-20T07:52:49.612Z",
"archivedAt": "2025-01-20T07:52:49.612Z",
"archived": true,
"path": "string",
"size": 0,
"name": "string",
"width": 0,
"id": "string",
"defaultHostingUrl": "string",
"updatedAt": "2025-01-20T07:52:49.612Z",
"height": 0
}

(*) required field

This Method allows you to automate the process of adding files to HubSpot’s File Manager.
This is useful for businesses that need to store and manage files such as images, PDFs, or documents that are used in various marketing, sales, and customer service activities.
 
See HubSpot doc.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*Upload a File
Connection*Select your connection or create one
Map Fields
Upload By *Choose the way to upload your file between:

File Data
This method will use Base64-encoded data to upload a file. Refer to Base64 encoding documentation.

Or  

URL
Upload a file from a given URL
Upload by File Data: File (base64-encoded data):

File Name*: Name of your file.
Extension*: Extension of your file (e.g. png).
Content (base64) *: Copy past the base64-encoded data here.
Or Upload by URLURL*: Address URL of your image
Access Type*Define the access type of your file:

Public, not indexable
Public, indexable
Private
Folder ID Select the folder where the file should be moved to.
Folder Id and Folder Path parameters cannot be set at the same time.
Folder PathSelect the folder Path, where the file should be moved to.
Folder Id and Folder Path parameters cannot be set at the same time.
Overwrite*: True-FalseOption to overwrite existing file with the same name and extension in the folder

(*) required field

This Method allows you to modify the properties of a file that is stored in HubSpot’s File Manager.
This method is typically used to update metadata or specific attributes associated with a file, such as its name, path, or other custom properties.
 
See HubSpot doc.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*Update File Properties
Connection*Select your connection or create one
Matching Criteria
File ID *  In the default value field, select the specific file you want to update information from within a dynamic list of available files in your HubSpot database.

Or map it from a step response. refer to Mapping methods.
Maps Fields
Access typeChange the access type of your file to:

Public, not indexable
Public, indexable
Private
Parent Folder IDFolder where the file should be moved to.
Folder Id and Folder Path parameters cannot be set at the same time.
Parent Folder PathManually enter the Folder Path, where the file should be moved to.
Folder Id and Folder Path parameters cannot be set at the same time.
NameUpdate the file name
Usable in Content:Define if this file can be use in content:
True – False

(*) required field

This Method will return the file with details such as name, height and width, encoding, and more by using the File URL (You can find the File URL from the Method “Search for Files“).
If a file is set to private, the returned URL will result in an error.
 
See ⁠⁠⁠⁠HubSpot doc.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*Get File Uploaded by Url
Connection*Select your connection or create one
Matching Criteria
File URL*  Enter the file URL, or map it from a step response.
Map Fields
If Not Found, Consider as*: Failed or successSuccess – When File ID is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.
{
"extension": "string",
"access": "PUBLIC_INDEXABLE",
"parentFolderId": "string",
"encoding": "string",
"type": "string",
"isUsableInContent": true,
"url": "string",
"expiresAt": 0,
"createdAt": "2025-01-20T07:52:49.612Z",
"archivedAt": "2025-01-20T07:52:49.612Z",
"archived": true,
"path": "string",
"size": 0,
"name": "string",
"width": 0,
"id": "string",
"defaultHostingUrl": "string",
"updatedAt": "2025-01-20T07:52:49.612Z",
"height": 0
}

(*) required field

This Method will mark the file as deleted and make the content of the file inaccessible.
To permanently delete a file, use the Method GDPR Delete File.
 
See ⁠⁠⁠HubSpot doc.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*Delete a File
Connection*Select your connection or create one
Matching Criteria
File ID*  In the default value field, select the specific file you want to remove within a dynamic list of available files in your HubSpot database.

Or map it from a step response. refer to Mapping methods.
Map Fields
If Not Found, Consider as*: Failed or successSuccess – When File ID is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.

(*) required field

This Method will permanently delete the file’s content and metadata within 7 days.
 
See ⁠⁠HubSpot doc.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*GDPR Delete a File
Connection*Select your connection or create one
Matching Criteria
File ID*  In the default value field, select the specific file you want to remove within a dynamic list of available files in your HubSpot database.

Or map it from a step response. refer to Mapping methods.
Map Fields
If Not Found, Consider as*: Failed or successSuccess – When File ID is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.

(*) required field

Search for folders. Does not contain hidden or archived folders.
 
See ⁠HubSpot doc.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*Search for Folders
Connection*Select your connection or create one
Map Fields [+Add Field] choose additional fields for the search:
Properties, After, Before, Sort, IDs, ID Lte, ID Gte, Create at, Create at Lte, Create at Gte, Update at, update at Lte, Update at Gte, Path, Parent IDs.
NameSearch for folders containing the specified name.
LimitNumber of items to return. Default limit is 10, maximum limit is 100.
If Not Found, Consider as*:Success – When Folder is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.
Additional fields
Properties to retrieveThis parameter allows you to specify which properties of the folder you want to search for.

[⊕ Element][⊕ Map] Add more fields or Map it from a Data Source. See Field Mapping.

Field name
For example, if you’re searching a folder, you might specify properties like “Create at”, “parent Folder Id”, and “name”. Property Fields that do not exist will be skipped.

Use Wiresk Lookup feature to search for the property name. Go to Default value > Lookup tab > search).
AfterOffset search results by this value. The default offset is 0 and the maximum offset of items for a given search is 10,000. Narrow your search down if you are reaching this limit.
Beforesame as After.
SortSort results by given property. For example -name sorts by name field descending, name sorts by name field ascending.

[⊕ Element][⊕ Map] Add more fields or Map it from a Data Source. See Field Mapping.

Field name
Order by : Ascending -Descending
IDslist of specific folder IDs you want to retrieve.

[⊕ Element][⊕ Map] Add more fields or Map it from a Data Source. See Field Mapping.

Folder ID
ID LteIf you want to search for folders within a certain ID range.
Filter folders where the ID is less than or equal to a given value.
ID GteIf you want to search for folders within a certain ID range.
Filter folders where the ID is greater than or equal to a given value.
Create atSearch folders by exact time of creation.
Create at LteSearch folders by less than or equal to time of creation. Can be used with created At Gte to create a range.
Create at GteSearch folders by greater than or equal to time of creation. Can be used with created At Lte to create a range.
Update atSearch folders by exact time of latest updated.
Update at LteSearch folders by less than or equal to time of latest update. Can be used with updated At Gte to create a range.
Update at GteSearch folders by greater than or equal to time of latest update. Can be used with updated At Lte to create a range.
PathSearch folders by path.
Parent Folder IDsSearch folders with the given parent folder Ids.

[⊕ Element][⊕ Map] Add more fields or Map it from a Data Source. See Field Mapping.

Parent Folder ID

(*) required field


  },
  "results": [
    {
      "createdAt": "2025-01-20T08:51:42.025Z",
      "archivedAt": "2025-01-20T08:51:42.025Z",
      "archived": true,
      "path": "string",
      "parentFolderId": "string",
      "name": "string",
      "id": "string",
      "updatedAt": "2025-01-20T08:51:42.025Z"
    }
  ]
}
This Method retrieves detailed information about a specified folder, including its name, creation date, modified date, parent folder, and subfolders.

You can use the “Get Folder” Method in Wiresk to:
Retrieve a list of files within a specific folder: Use the “Get file” Method with the folder ID obtained from “Get Folder” “to retrieve a list of files within that folder.
Check if a folder exists: Use the “Get Folder” Method with a specified folder ID.
Create subfolders: Use the “Create Folder” to create subfolders within a specific folder.
 
See HubSpot doc.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*Get Folder
Connection*Select your connection or create one
Map Fields
Folder ID *  In the default value field, select the specific folder you want to retrieve information from within a dynamic list of available folders in your HubSpot database.

Or map it from a step response. refer to Mapping methods.
If Not Found, Consider as*: Failed or successSuccess – When Folder ID is not found during execution, the system does not treat this as an error. Instead, it considers the operation successful and continues with the workflow.

Failed – Wiresk treats this as an error or failure. The workflow stops or takes a predefined failure action.

(*) required field

This Method allows you to automatically create a folder in your HubSpot account. This method is often used to organize assets, files, or other resources within HubSpot.
 
See HubSpot doc.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*Create a Folder
Connection*Select your connection or create one
Map Fields
Parent Folder ID
Folder Id and Folder Path parameters cannot be set at the same time.		Select an existing folder in your HubSpot database under which the new folder will be created. If no parent folder is specified, it would default to the root directory.
Parent Folder Path
Folder Id and Folder Path parameters cannot be set at the same time.		This field is used to specify the path (or location) of an existing folder, where the new folder will be created. (E.g. marketing/2024/)
Name*Name of the folder you want to create.

(*) required field

HUBSPOT HubSpot CRM - Files, Workflows, Events

Use workflows in HubSpot CRM to automate your marketing, sales, and service processes.
Set enrollment criteria to enroll specific records or manually enroll your contacts.

Get a list of workflows for a HubSpot portal. This Method is particularly useful if you are looking for a particular workflow and need to look it up by an Id. The Method only returns metadata for each workflow.
This Method can also be used when syncing to a CRM system to display a list of workflows a salesperson can enroll a prospect into.
 
See HubSpot doc.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*List Workflows
Connection*Select your connection or create one
Map Fields
AfterThe paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.
LimitThe maximum number of results to display per page.
Default value: 100

(*) required field

Example GET URL:
https://api.hubapi.com/automation/v3/workflows/

Example response:
{
  "workflows": [
    {
      "name": "Testing 123",
      "id": 10900,
      "type": "DRIP_DELAY",
      "enabled": false,
      "insertedAt": 1348564640837,
      "updatedAt": 1467737836223,
      "personaTagIds": [
        
      ],
      "contactListIds": {
        "enrolled": 300,
        "active": 68737,
        "steps": [
          
        ]
      }
    },
    {
      "name": "Test 2",
      "id": 12707,
      "enabled": false,
      "insertedAt": 1349673659792,
      "updatedAt": 1349673659792,
      "personaTagIds": [
        
      ],
      "contactListIds": {
        "enrolled": 309,
        "active": 68738,
        "steps": [
          
        ]
      }
    },
    {
      "name": "Example Workflow",
      "id": 23505,
      "enabled": false,
      "insertedAt": 1353448650631,
      "updatedAt": 1353448650631,
      "personaTagIds": [
        
      ],
      "contactListIds": {
        "enrolled": 318,
        "active": 68740,
        "steps": [
          
        ]
      }
    },
    // ...
  ]
}
Returns metadata for a workflow, including the starting conditions and workflow steps. Workflow IDs can be found by using the List Workflows Method.
When using this API, only certain actions are supported. If unsupported actions are included, the action type returned will be UNSUPPORTED_ACTION. For a list of supported actions, refer to the Supported Actions table.
 
See HubSpot doc.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*Get Workflow
Connection*Select your connection or create one
Map Fields
Workflow ID*Select the existing Workflow to get it Metadata.

(*) required field

Example GET URL:
https://api.hubapi.com/automation/v3/workflows/10900

Example Response:
{
  "name": "Testing 123",
  "actions": [
    
  ],
  "id": 10900,
  "type": "DRIP_DELAY",
  "enabled": false,
  "portalId": 62515,
  "internal": false,
  "onlyExecOnBizDays": true,
  "nurtureTimeRange": {
    "enabled": false,
    "startHour": 9,
    "stopHour": 10
  },
  "listening": false,
  "insertedAt": 1348564640837,
  "updatedAt": 1467737836223,
  "allowContactToTriggerMultipleTimes": false,
  "unenrollmentSetting": {
    "type": "NONE",
    "excludedWorkflows": [
      
    ]
  },
  "recurringSetting": {
    "type": "NONE"
  },
  "enrollOnCriteriaUpdate": false,
  "onlyEnrollsManually": false,
  "goalCriteria": [
    [
      {
        "propertyObjectType": "COMPANY",
        "filterFamily": "CompanyPropertyValue",
        "withinTimeMode": "PAST",
        "property": "active__c",
        "value": "Yes",
        "type": "enumeration",
        "operator": "SET_ANY"
      }
    ]
  ],
  "reEnrollmentTriggerSets": [
    
  ],
  "suppressionListIds": [
    
  ],
  "lastUpdatedBy": "test@hubspot.com",
  "segmentCriteria": [
    
  ],
  "metaData": {
    "triggeredByWorkflowIds": [
      
    ],
    "succeededListId": 183192,
    "contactListIds": {
      "active": 68737,
      "completed": 301,
      "succeeded": 183192,
      "enrolled": 300
    }
  }
}
This Method allows you to enroll a contact to a workflow if certain conditions are met.
 
See HubSpot doc.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*Add a Contact to a Workflow
Connection*Select your connection or create one
Map Fields
Email*Select the contact’s email you wish to enroll in the workflow.
Workflow ID*Select your existing Workflow to add your contact.

(*) required field

If a contact is removed from a workflow, all future events that they are scheduled for will not take place.
One application of this endpoint could be removing a contact from a marketing automation workflow if they are closed as a customer in your CRM.
 
See HubSpot doc.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*Remove a Contact from a Workflow
Connection*Select your connection or create one
Map Fields
Email*Select the contact’s email you wish to unenroll in the workflow.
Workflow ID*Select your existing Workflow to remove your contact.

(*) required field

HUBSPOT HubSpot CRM - Files, Workflows, Events
Require Developer API Key & App ID in app connection, refer to the Advanced connection steps.
Creates or updates a timeline event.See more details on the API Endpoint reference on HubSpot here.

Configuration Table:

Input Options (Field Mapping):

  • Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
  • Default Value: Select value from a defined list or specify a fixed attribute.
  • Manual input: Set a custom value by using the Lightning Bold feature.
Name*Create a Single Event
Connection*Select your connection or create one
Map Fields
Event Template ID*Select the Template Event.
Object IDThe CRM object identifier. This is required for every event other than contacts (where utk or email can be used).
UTKUse the utk parameter to associate an event with a contact by usertoken. This is recommended if you don’t know a user’s email, but have an identifying user token in your cookie.
EmailThe email address used for contact-specific events. This can be used to identify existing contacts, create new ones, or change the email for an existing contact (if paired with the objectId).
DomaineThe event domain (often paired with utk).
DateThe time the event occurred. If not passed in, the curren time will be assumed. This is used to determine where an event is shown on a CRM object’s timeline.
Value example: “2020-01-30T17:42:10.276Z”
Extra DataAdditional event-specific data that can be interpreted by the template’s markdown.
Tokens*A collection of token keys and values associated with the template tokens.

[⊕ Element][⊕ Map] Add more Extra data fields or Map it from a Data Source. See Field Mapping.

Key Value*
Timeline FrameIf included, the event will display a link that will open an IFrame. This is an object that must have the following fields:

Link Label*: The text used to display the link that will display the IFrame.

Header Label*: The label of the modal window that displays the IFrame contents.

URL*: The URI of the IFrame contents.

Width*: The width of the modal window in pixels.

Height*: The hight of the modal window in pixels.

(*) required field

{
  "objectType": "contacts",
  "id": "petspot:1001298:art3mis-pup@petspot.com-004",
  "eventTemplateId": "1001298",
  "email": "art3mis-pup@petspot.com",
  "objectId": "28001",
  "timestamp": "2020-01-30T17:42:10.276Z",
  "tokens": {
    "petName": "Art3mis",
    "petColor": "black",
    "petAge": "3"
  },
  "extraData": {
    "questions": [
      {
        "question": "Who's a good girl?",
        "answer": "Bark!"
      },
      {
        "question": "Do you wanna go on a walk?",
        "answer": "Woof!"
      }
    ]
  },
  "timelineIFrame": {
    "linkLabel": "View Art3mis",
    "headerLabel": "Art3mis dog",
    "url": "https://my.petspot.com/pets/Art3mis",
    "width": 600,
    "height": 400
  }
}

Once your Flow is configured, you can test or automate it using the Run panel or by managing Triggers from the Flow Management screen.

  • Run Flow: Manually runs the Flow once using sample data. Ideal for testing logic and field mapping. See How to Run a Flow.
  • Run Scheduler: Force-runs the Trigger immediately using live input. This bypasses the recurrence rule and is useful for verifying real data mapping. Learn more in Wiresk Scheduler – The Fundamentals.

From the Trigger management panel (clock icon), you can:

  • Activate or deactivate Triggers
  • Force-run the scheduler
  • Copy Routing Keys (for HTTP Triggers)

If your Flow uses a Webhook Trigger, it runs automatically on each incoming webhook—no scheduler required. It remains active until you manually deactivate it.