Veeqo Integration
The Veeqo integration connects EventWorks to your Veeqo account, letting you sync your product catalogue into your resource library, create orders from event costs, and import orders from Veeqo as new events.
Getting There
Go to Settings > Integrations and find the Veeqo card. Click Connect to enter your API key and configure the integration.
Overview
Once connected, Veeqo provides three main capabilities:
- Sync products — Import your Veeqo product catalogue as resources and variants in EventWorks
- Create orders — Push orders to Veeqo from your event cost sheets, matched by SKU
- Import orders — Pull recent Veeqo orders into EventWorks as new events with accounts, contacts, and costs
Key Concepts
API Key Authentication
Veeqo connects using an API key from your Veeqo account.
SKU Matching
When creating orders, EventWorks matches cost line items to Veeqo products using SKU codes. Your resources and variants in EventWorks need matching SKUs from the Veeqo product sync.
Attribute Mapping
Delivery address fields, contact details, and other order data are mapped to EventWorks custom attributes. You configure which custom attribute stores each piece of data.
How To...
Connect to Veeqo
- Go to Settings > Integrations.
- Click the Veeqo card.
- Fill in the connection details:
- Configure attribute mappings for imported order data (contact name, phone, address fields, delivery method, gift message).
- Set the Import status and Import type for events created from imported orders.
- Click Save.
Sync Products from Veeqo
To import your Veeqo product catalogue into EventWorks:
- On the Veeqo integration card, click Sync products.
- EventWorks fetches all products from Veeqo and creates or updates resources in your library.
- Each product becomes a resource, and each sellable variant becomes a variant with its SKU, cost price, and image.
The sync runs in the background. Products are matched by their Veeqo ID — if a product already exists in EventWorks, it's updated rather than duplicated. Variants that no longer exist in Veeqo are removed.
Create Orders in Veeqo
To push event costs as orders to Veeqo:
- Navigate to the event's Costs or Resources page.
- Use the Send to Veeqo action.
- EventWorks creates orders in Veeqo based on your cost groups:
Note: Only costs with resources that have matching Veeqo SKUs will be included in orders.
Import Orders from Veeqo
To pull recent Veeqo orders into EventWorks as events:
- On the Veeqo integration card, click Import orders.
- EventWorks fetches orders created since the last import.
- Each order becomes a new event with:
You can filter which orders are imported using the Import tag and Import channel settings.
Disconnect Veeqo
- On the Veeqo integration card, click Disconnect.
Settings & Configuration
All Veeqo settings are configured in the connection modal at Settings > Integrations. You need the edit settings permission.
Connection Settings
| Setting | Description |
|---|---|
| API key | Your Veeqo API key |
| Channel ID | The Veeqo sales channel for order creation |
Import Settings
| Setting | Description |
|---|---|
| Import tag | Only import orders with this tag |
| Import channel | Only import orders from this channel |
| Import status | Event status assigned to imported orders |
| Import type | Event type assigned to imported orders |
Attribute Mappings
Map Veeqo order data to EventWorks custom attributes:
| Field | Description |
|---|---|
| Contact name | Custom attribute for the customer's name |
| Contact phone | Custom attribute for the customer's phone |
| Address 1 | Custom attribute for delivery address line 1 |
| Address 2 | Custom attribute for delivery address line 2 |
| City | Custom attribute for the delivery city |
| County | Custom attribute for the delivery county/state |
| Postcode | Custom attribute for the delivery postcode |
| Country | Custom attribute for the delivery country |
| Delivery method | Custom attribute for the delivery method |
| Delivery/set up field | Custom attribute for delivery/set-up type |
| Gift message | Custom attribute for gift messages |
Frequently Asked Questions
Q: How are products matched between Veeqo and EventWorks?Products are matched by their Veeqo ID. During a product sync, new products are created as resources and existing products are updated. Variants are matched by both Veeqo ID and resource.
Q: What happens if a line item's SKU doesn't match a Veeqo product?The order will still be created, but line items without matching SKUs may not be included or may be flagged. Ensure your resource variants have the correct SKUs from the product sync.
Q: Can I import all Veeqo orders?By default, all orders since the last import are fetched. Use the Import tag and Import channel settings to filter to specific orders.
Q: Are existing events duplicated when importing?No. Orders are matched by their order number/code. If an event already exists with that code, it's updated rather than duplicated.