Simvoly¶
The Simvoly modules allow you to monitor, create, update, list, retrieve, and delete the bookings, contacts, form submissions, members, products, and orders from your Simvoly account.
Getting Started with Simvoly¶
Prerequisites
- A Simvoly account - create an account at simvoly.com/.
Connecting the Simvoly to Ibexa Connect¶
To connect your Simvoly account to Ibexa Connect you need to obtain the API Key from your Simvoly account and insert it in the Create a connection dialog in the Ibexa Connect module.
1. Log in to your Simvoly account.
2. Click Settings > Applications.
3. Copy the API Key to your clipboard.
4. Log in to your Ibexa Connect account and add a module from the Simvoly app into an Ibexa Connect scenario.
5. Click Add next to the Connection field.
6. In the Connection name field, enter a name for the connection.
7. In the Domain field, enter your account URL address. For example, https://example.simvoly.com
.
8. In the API Key field, enter the API key copied in step 3, and click Continue.
The connection has been established.
Contact¶
Ibexa Connect automatically creates a webhook in Simvoly once you add an instant trigger to your scenario.
Watch Contact Activities¶
Triggers when a new contact is created or an existing contact is updated.
Webhook Name | Enter a name for the webhook. |
Watch Contacts¶
Triggers when a new contact is created.
Limit | Set the maximum number of contacts Ibexa Connect should return during one execution cycle. |
List Contacts¶
Retrieves a list of contacts.
Created at Minimum | Enter (map) the date and time to list the contacts that were created on or after the specified time. See the list of supported date and time formats. |
Created at Maximum | Enter (map) the date and time to list the contacts that were created on or before the specified time. See the list of supported date and time formats. |
Limit | Set the maximum number of contacts Ibexa Connect should return during one execution cycle. |
Get a Contact¶
Retrieves an existing contact.
Contact ID | Select or map the Contact ID whose details you want to retrieve. |
Create a Contact¶
Creates a new contact.
Enter (map) the email address of the contact. | |
Name | Enter (map) the contact's name. |
Phone | Enter (map) the contact's phone number. |
Note | Enter (map) the additional information about the contact. |
Address | Enter (map) the street name of the contact. |
City | Enter (map) the contact's city name. |
State | Enter (map) the contact's state name. |
ZIP | Enter (map) the contact's area ZIP code. |
Country | Enter (map) the contact's country name. |
Company Name | Enter (map) the contact's company name. |
Properties | Add the properties for the contact. For example, the contact's the company address . |
Tags | Add the tags for the contact separated by a comma. |
Update a Contact¶
Updates an existing contact.
Contact ID | Select or map the Contact ID whose details you want to update. |
Enter (map) the email address of the contact. | |
Name | Enter (map) the contact's name. |
Phone | Enter (map) the contact's phone number. |
Note | Enter (map) the additional information about the contact. |
Address | Enter (map) the street name of the contact. |
City | Enter (map) the contact's city name. |
State | Enter (map) the contact's state name. |
ZIP | Enter (map) the contact's area ZIP code. |
Country | Enter (map) the contact's country name. |
Company Name | Enter (map) the contact's company name. |
Properties | Add the properties for the contact. For example, the contact's the company address . |
Tags | Add the tags for the contact separated by a comma. |
Delete a Contact¶
Deletes an existing contact.
Contact ID | Select or map the Contact ID you want to delete. |
Members¶
Watch Members¶
Triggers when a new member is created.
Limit | Set the maximum number of members Ibexa Connect should return during one execution cycle. |
List Members¶
Retrieves a list of members.
Limit | Set the maximum number of members Ibexa Connect should return during one execution cycle. |
Get a Member¶
Retrieves an existing member.
Member ID | Select or map the Member ID whose details you want to retrieve. |
Create a Member¶
Creates a new member.
Name |
Enter (map) the name of the member. |
||||||||||||||||||||||
Enter (map) the member's email address. |
|||||||||||||||||||||||
Password |
Enter (map) the member's password. |
||||||||||||||||||||||
Groups |
Select or map the groups to which you want the member to. |
||||||||||||||||||||||
Approved |
Select whether the member status is approved. |
||||||||||||||||||||||
Billing Address |
Add the billing address of the member:
|
||||||||||||||||||||||
Shipping Address |
Add the shipping address of the member:
|
Update a Member¶
Updates an existing member.
Member ID |
Select or map the Member ID whose details you want to update. |
||||||||||||||||||||||
Name |
Enter (map) the name of the member. |
||||||||||||||||||||||
Enter (map) the member's email address. |
|||||||||||||||||||||||
Password |
Enter (map) the member's password. |
||||||||||||||||||||||
Groups |
Select or map the groups to which you want the member to. |
||||||||||||||||||||||
Approved |
Select whether the member status is approved. |
||||||||||||||||||||||
Billing Address |
Add the billing address of the member:
|
||||||||||||||||||||||
Shipping Address |
Add the shipping address of the member:
|
Delete a Member¶
Deletes an existing member.
Member ID | Select or map the Member ID you want to delete. |
Products¶
Ibexa Connect automatically creates a webhook in Simvoly once you add an instant trigger to your scenario.
Watch Product Created¶
Triggers when a new product is created.
Webhook Name | Enter a name for the webhook. |
Watch Product Updated¶
Triggers when a new product is updated.
Webhook Name | Enter a name for the webhook. |
Watch Products¶
Triggers when a new product is created.
Limit | Set the maximum number of products Ibexa Connect should return during one execution cycle. |
List Products¶
Retrieves a list of products.
Title | Enter (map) the product name to list the products that match the specified name. |
Category ID | Enter (map) the Category ID to list the product that matches the specified product category. |
Limit | Set the maximum number of products Ibexa Connect should return during one execution cycle. |
Get a Product¶
Retrieves an existing product.
Product ID | Select or map the Product ID whose details you want to retrieve. |
Create a Product¶
Creates a new product.
Type |
Select or map the product type:
|
||||||||||||||
Title |
Enter (map) the product name. |
||||||||||||||
Variants |
Add the product variant details:
|
||||||||||||||
Description |
Enter (map) the product details. |
||||||||||||||
URL |
Enter (map) the product URL address in your store. |
||||||||||||||
Hidden |
Select whether the product is visible in your store. |
||||||||||||||
Images |
Add the image URL address of the product. |
||||||||||||||
Categories |
Add the product categories:
|
||||||||||||||
Options |
Add the options for the product:
|
||||||||||||||
Subscription |
Add the subscription details of the product:
|
||||||||||||||
File |
Enter (map) the digital file details if the product you are selling is a digital product. |
||||||||||||||
Update Existing Product by URL |
Select whether if this is an existing product. If the product is existing then the details will be updated. |
Update a Product¶
Updates an existing product.
Product ID |
Select or map the Product ID whose details you want to update. |
||||||||||||||
Title |
Enter (map) the product name. |
||||||||||||||
Variants |
Add the product variant details:
|
||||||||||||||
URL |
Enter (map) the product URL address in your store. |
||||||||||||||
Hidden |
Select whether the product is visible on your store front side. |
||||||||||||||
Images |
Add the image URL address of the product. |
||||||||||||||
Categories |
Add the product categories:
|
||||||||||||||
Options |
Add the options for the product:
|
||||||||||||||
Subscription |
Add the subscription details of the product:
|
||||||||||||||
File |
Enter (map) the digital file details if the product you are selling is a digital product. |
Delete a Product¶
Deletes an existing product.
Product ID | Select or map the Product ID you want to delete. |
Orders¶
Ibexa Connect automatically creates a webhook in Simvoly once you add an instant trigger to your scenario.
Watch Order Created¶
Triggers when a new order is created.
Webhook Name | Enter a name for the webhook. |
Watch Order Updated¶
Triggers when a new order is updated.
Webhook Name | Enter a name for the webhook. |
Watch Orders¶
Triggers when a new order is created.
Limit | Set the maximum number of orders Ibexa Connect should return during one execution cycle. |
List Orders¶
Retrieves a list of orders.
Created at Minimum | Enter (map) the date to list the orders that were created on or after the specified date. |
Created at Maximum | Enter (map) the date to list the orders that were created on or before the specified date. |
Limit | Set the maximum number of orders Ibexa Connect should return during one execution cycle. |
Get an Order¶
Retrieves an existing order.
Order ID | Select or map the Order ID whose details you want to retrieve. |
Forms¶
Ibexa Connect automatically creates a webhook in Simvoly once you add an instant trigger to your scenario.
Watch Submissions¶
Triggers when a form is submitted.
Webhook Name | Enter a name for the webhook. |
Watch Form Submissions¶
Triggers when a form is submitted.
Limit | Set the maximum number of submissions Ibexa Connect should return during one execution cycle. |
List Form Submissions¶
Retrieves a list of form submissions.
From | Enter (map) the date to list the submissions that were created on or after the specified date. |
To | Enter (map) the date to list the submissions that were created on or before the specified date. |
Limit | Set the maximum number of submissions Ibexa Connect should return during one execution cycle. |
Bookings¶
Ibexa Connect automatically creates a webhook in Simvoly once you add an instant trigger to your scenario.
Watch Booking Created¶
Triggers when a new booking is created.
Webhook Name | Enter a name for the webhook. |
Watch Bookings¶
Triggers when a new booking is made.
Limit | Set the maximum number of bookings Ibexa Connect should return during one execution cycle. |
List Bookings¶
Retrieves a list of bookings.
From | Enter (map) the date to list the bookings that were created on or after the specified date. |
To | Enter (map) the date to list the bookings that were created on or before the specified date. |
Event ID | Enter (map) the Event ID whose bookings you want to watch. |
Limit | Set the maximum number of bookings Ibexa Connect should return during one execution cycle. |
Other¶
Make an API Call¶
Performs an arbitrary authorized API call.
URL |
Enter a path relative to For the list of available endpoints, refer to the Simvoly API Documentation. |
Method |
Select the HTTP method you want to use: GETto retrieve information for an entry. POSTto create a new entry. PUTto update/replace an existing entry. PATCHto make a partial entry update. DELETEto delete an entry. |
Headers |
Enter the desired request headers. You don't have to add authorization headers; we already did that for you. |
Query String |
Enter the request query string. |
Body |
Enter the body content for your API call. |
Example of Use - List Orders¶
The following API call returns all the orders from your Simvoly account:
URL:/api/site/orders
Method:GET
Matches of the search can be found in the module's Output under Bundle > Body > items. In our example, 5 orders were returned: