Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Guides to Configuring OAuth2 Applications
A universal guide outlining the common steps involved in setting up any OAuth2 application, including registering your application, obtaining client credentials, and defining redirect URIs.
The first thing you need is an app created in the developer portal. Navigate to https://developer.blackboard.com and signup for an account. When you are logged in, you can see a dashboard with a list of your applications and a button to create a new one:
Note that listed applications have an Application ID. We will need it when we register our application in the blackboard instance. Click on the + button to create a new application. A simple form appears with your Application name and description inputs, and a domains input, for your domains. After you fill in the fields, create the new application.
Log in with admin privileges, and go to the System Admin tab in the top menu. After that, look under Integrations for REST API Integrations:
Next, you will see a list with all your API Integrations. Click on Create Integration to add a new one:
After that, you will show a small form. One of the inputs is the Application ID which as we showed in the first step, is available in the applications list at the developer portal. Next, browse and select a user. We recommend using the same user you are logged in with. On the End User Access and Authorized To Act As User, select Yes in both options. After that click on Submit to finish the registration.
Finally, we need to set the OAuth clientId and clientSecret in the Backoffice to finish the integration. To obtain these values, go to the applications list in the developer portal. Find your application and click on the 3 dots at the end of the row. Then click on the Manage Keys option:
After you will see a list of your application keys. Click on the + sign to create a new key. Your key will be created and its information will be shown to you:
Be sure to store this information somewhere safe, as you won't be able to get it again.
Next, log into the Backoffice and go to Services. Next create a configuration for appmixer:blackboard. Finally, add your Application ID as clientId and Secret as clientSecret. Also set serverUrl to your instance URL:
And you are done! You are ready to use the Blackboard module.
https://www.activecampaign.com/
Sign-in to to your ActiveCampaign account. Once you are logged in, locate the "Settings" option. This can be found in the bottom left corner of the homepage.
Within the settings page, you will see a section labeled 'Developer'. Click on this section to navigate to the Developer page. On the 'Developer' page, you will see your API URL and your API key.
use the API Key to authenticate ActiveCampaign components in the Appmixer Designer.
Configure the Dropbox.
Open the .
Log in with your Dropbox account credentials.
Set the Redirect URI to https://[YOUR_API_BASE]/auth/dropbox/callback
, for example https://api.appmixer.com/auth/dropbox/callback
To allow additional users, click on "Enable Additional Users.
Configure the App Key as clientId
and the App Secret as clientSecret
in the service settings within the Backoffice, under the configuration ID appmixer:dropbox
.
Ensure that the following permissions are selected:
account_info.read
files.content.read
files.content.write
files.metadata.read
Visit and create a new OAuth application (or use your existing one).
Add Facebook Login for Business and Marketing API products.\
Copy the App ID and App Secret a and paste it to your Appmixer Backoffice -> Connector Configuration page under the appmixer:facebookbusiness
configuration ID as clientId
and clientSecret
, respectively:\
Add your Appmixer tenant domains as your App domains:\
Note: replace YOUR_TENANT with the name of your hosted tenant. If you're a customer on an Appmixer Self-Managed plan, you can have a completely custom domains that Appmixer runs on. Use your own domains instead.
Set the OAuth redirect URI under Facebook Login for Business / Settings to https://api.YOUR_TENANT.appmixer.cloud/auth/facebookbusiness/callback
:\
Sign up with Freshdesk:
Navigate to Profile Settings -> API. Copy the API token on the right side. If you don't see the API key, please refer to the for more information.
Use the copied token as API key
along with Domain
when connecting Freshdesk components in Appmixer. In this example the domain is acme-help
and the API key is the copied token.
In 2020 Google introduced Application verification If an app uses Google APIs to access Google users’ data. This makes it impossible to use the Appmixer Google modules in production without the verification process. Such a verification process has to be done by you.
Most of the Google modules need what Google marks as Sensitive or Restricted Scope in order to work. For example, the Gmail module needs scope to create a new email and to get new emails.
Originally, the Gmail module was the only one affected by this new Google policy. But new scopes are being marked as restricted. Later, they shut down the older Spreadsheets API, and with the new API, the only way to get a list of users Spreadsheets is to use the Drive API and restricted scope .
The last (up to now) module affected by this policy is the Drive module.
Go to the Google developer console at and create a new project.
When the project is created, add some APIs.
Add the Gmail API.
The Google Sheets API.
The Google Drive API.
The Google Calendar API.
The Analytics API.
The YouTube API.
The next step is the OAuth consent screen.
User Type - Internal vs External. The Internal user type allows you to use the Google modules without the app verification process mentioned at the beginning of this page. However, the modules will work only for accounts within your organization.
We are going to choose External for the purpose of this tutorial.
On the next page, leave the scopes empty.
You can add test users, but you can do this later. Only users added as test users will be able to authenticate!
Here is the Oauth consent screen configured. The app is in the testing mode, it is external (for users outside your organization). No more than 100 accounts (user cap) can be used with this application.
We need a client ID and a client secret.
Choose the Web application type and give it a name and authorize redirect URI.
For the purpose of this tutorial, we are going to use localhost:2200 which is the default port for the Appmixer API when running on localhost. If you are creating an Oauth application for your production/QA, the URI of your server will be here. The suffix /auth/google/callback will remain there.
You will get your Client ID and Client Secret.
By default the callback URL passed to Google is in the form of <your-api-url>/auth/appmixer:google/callback. However in some cases, you could need to pass a different callback URL. You can do this by inserting a callbackUrl value in the service configuration:
When you use a Google Webhook component without a verified domain, you will receive the Unauthorized WebHook callback channel error.
First, open the Google developers console and your Appmixer project and follow the instructions in the next picture.
Add your Appmixer tenant API URL (api.YOUR_TENANT.appmixer.cloud
) and continue to verify the domain ownership. Click 'Take me there' and then 'Add a property'.
Again, use api.YOUR_TENANT.appmixer.cloud
. Then download the HTML verification file.
After you download your HTML verification file, upload it via the Appmixer Backoffice interface to the Public Files section on the left. When you are done you should see your file listed:
Click the 'Verify' button to finish the verification process.
Now, you can go back to the developer console and add the api.YOUR_TENANT.appmixer.cloud
domain once more. But this time, because it's already verified, it will appear in the list of your domains.
The new domain has to be added to the OAuth consent screen as well.
Unfortunately, since August 20, 2018 no longer accepts signups.
We keep the module in Appmixer for the older customers who have their Oauth2 application. If you are a new Appmixer customer, you won't be able to create the OAuth2 application and therefore use the Highrise module. In that case, you should remove it from the platform.
Requests to the Highrise API contain headers with User-Agent
property. This is set by default to Appmixer
, but it can be overwritten using Backoffice:
You can find all the necessary information on how to register an OAuth app in Jira in their .
Access and create a new app. Click Create and select OAuth 2.0 integration.
Click on the "Register an app" button.
You need to specify the scopes that your app will use. For Jira, you will need to select the following scopes:
read:me
read:jira-work
write:jira-work
manage:jira-project
manage:jira-configuration
read:jira-user
report:personal-data
This is how the permissions should look like:
After you have created the app, you will see the overview of the app. Here you can find the client ID and client secret.
clientId
, clientSecret
into Appmixer Backoffice.The last step is to configure clientId and clientSecret in the Appmixer Backoffice for appmixer:jira
connector.
You need to create a developer account first (more about different Hubspot accounts can be found here)
Create a new application.
In order to get rid of a warning that your users will see before installing Hubspot module, you have to verify your identity as an app provider.
You can manage the Contact & Support settings.
Or skip for now.
Set the application name, logo, and description.
Go back to Hubspot and set the redirect URL, replace acme.com with your domain and keep the suffix /auth/hubspot/callback
Adding scopes.
Hit Save.
One more thing that you will need is the Hubspot, go back to the Apps page and hit the Get HubSpot API key button.
Your domain is unverified Until your domain is set and verified, users will see a warning when installing your app.
Users will encounter this warning during the installation or management of the app. To eliminate this warning, the verification process must be completed. HubSpot mandates the configuration of a DNS TXT record as the sole method for verification.
To configure and verify a custom HubSpot app for a hosted instance of Appmixer, such as ACME.appmixer.cloud, you will need to establish a custom domain for the Appmixer instance (for example, ACME.com). Without this custom domain, domain verification will not be possible.
In order to offer the Azure Cognitive Services components to your customers, you have to set an Azure key and endpoint through the Backoffice first.
Register an OAuth2 application in a similar way as usual with few changes:
you don't need to configure OneDrive file picker
configure API permissions for Dynamics 365, see below
Go to the API permissions section:
Choose Dynamics CRM:
Delegated permissions:
The final set of permissions:
Creating CRM Dataverse environment
Once created you can view details of the environment and see Environment URL address which you will need when connecting a Microsoft Dynamics 365 CRM component to your account.
Note that in order to interact with Lead entities, you'll need to install Sales module into your Dataverse environment. Some entities like Contact or Account come with a Dataverse environment by default, but it is not the case for Lead entity.
Addition configuration
Microsoft Dynamics 365 CRM connector has additional settings when it comes to caching Dataverse environment schema and data. These settings can be configured in the Backoffice the same way as clientId or clientSecret:
listLookupOptionsCacheTTL
- Cache TTL for inspector variables in milliseconds. Default value 1 minute. Determines how long the values of various Lookup fields are stored in Appmixer cache. This affects values fetched into select boxes in the inspector for fields like Currency, Contact, etc.
listOutportCacheTTL
- Cache TTL for outports in milliseconds. Default 1 hour. Determines how long Appmixer caches the structure of the Dataverse instance (environment) for output ports. In case you add a new table or change an existing table (eg. by changing column type), this is the time you need to wait before the changes are propagated into components outPort schema.
listInspectorCacheTTL
- Cache TTL for inspector in milliseconds. Default 1 hour. Similar to listOutportCacheTTL
. Determines how long Appmixer caches the structure of the Dataverse instance (environment) for the inspector. In case you add a new table or change an existing table (eg. by changing column type), this is the time you need to wait before the changes are propagated into the component's inspector.
Go to the page (you can also get there from the )
Add a new app:
Get the ClientId, ClientSecret and set the redirect URI:
clientId
: Integration Key
clientSecret
: Secret Keys
And set the clientId
, clientSecret
to the service configuration in the Backoffice.
https://platform.openai.com
OpenAI Account: The first thing you need to do is have an OpenAI account. You can sign up for free.
After signing up, go to https://platform.openai.com/api-keys.
Create a New API Key: You would find a button or link labeled "Create a new key" or "Generate API keys". Click on it.
Keep this key safe and secure. It should not be shared with anyone or exposed in client-side code, as it could be used to misuse your OpenAI services.
use the API Key to authenticate OpenAI components in the Appmixer Designer.
You will need to create a new Redmine installation. Go to and follow the instructions. Alternatively, you can use a Docker image: or a hosted solution.
Once you have your Redmine application make sure you have the REST API enabled. Go to Administration -> Settings -> API and check the "Enable REST web service" option.
After that, you will need to create a new API key. Go to Administration -> Users -> Edit user and create a new API key.
You will enter this API key and also the URL of your Redmine installation in when connecting each Redmine component.
Configure the Jotform.
Go to the .
Log in with your JotForm account credentials.
Navigate to Account Settings: Click on your avatar/initials in the top right corner of the page. Choose "Settings" from the dropdown menu. Or go directly to the
Here, you might see a list of existing API keys if you've created any before. To generate a new one, click the “Create New Key” button
In the authentication pop-up enter your API key.
Sign up with Mailchimp:
Now you need to add an OAuth application. Navigate to: Profile > Extras > Registered apps.
Click on the "Register an app" button.
Now save the OAuth client and copy the client ID and secret. You will need them later.
clientId
, clientSecret
and subdomain
into Appmixer Backoffice.The last step is to configure clientId and clientSecret in the Appmixer Backoffice for appmixer:mailchimp
connector.
Appmixer offers a built-in component for taking Screenshots.
It uses API. If you want to have this module on the platform you have to create your own Screenshot account and set the API token in the Backoffice.
App admin url:
Once the app admin account is created and verified you need to create an instance.
It will take a minute or two or three or five to complete.
To configure webhooks in ServiceNow to receive notifications when a new record is created, follow these steps. This involves creating an Outbound REST Message, setting up a Business Rule to capture record creation, and configuring the webhook.
Navigate to System Web Services > Outbound > REST Message.
Click on the New button to create a new REST Message.
Fill in the fields such as:
Name: e.g., AppmixerNotifications
.
Click Submit and then open the newly created REST Message.
Click on the HTTP Methods tab and create a new HTTP Method.
Fill in the details such as:
Name: e.g., events
.
HTTP Method: POST.
Endpoint: Ensure this is filled with your webhook listener’s URL.
Optionally, add default HTTP Request Headers (e.g., Content-Type) and customize the Request Body or Query Parameters if needed.
Save the HTTP Method.
Navigate to the table for which you want to capture new record creation. For example, if it’s the Incident table, go to Incident > All.
Right-click on the form header and select Configure > Business Rules.
Alternatively, you can navigate to Activity Subscriptions -> Administration -> Business Rules.
Click on the New button to create a new Business Rule.
Set the fields as follows:
Name: e.g., Incident Rules
.
Table: Select the appropriate table (e.g., Incident
).
When: Insert.
Under Advanced, check the box Advanced to open the script editor.
In the Script section, add the following code:
Note that AppmixerNotifications
should be the same as the name of the Outbound REST Message in the previous step.
The code above handles only new records in the incidents
table. If you want to track new items in other tables, create another business rules and send the notifications to the Appmixer endpoint, where the type
of the event is in format like: '.insert':
Go to and create a new app.
Name your application and select a workspace.
Then you receive your clientID and clientSecret.
After that create an App-Level Token with the following scopes: authorizations:read
. This token is used verify authorization of the user for incoming Events API requests from Slack.
Copy and paste those values into the Backoffice.
clientID
is the Client ID
from the Slack app.
clientSecret
is the Client Secret
from the Slack app.
authToken
is the App-Level Token
from the Slack app.
The next thing is adding the redirect URL and scopes.
And add these scopes.
In order to use the application accross workspaces you have to distribute it.
The Request URL has to point to your Appmixer backend server. The rest of the URL /plugins/appmixer/slack/events
has to remain like this. Your Appmixer backend server has to be running before you enter the URL. Slack will immediately try to connect to that URL.
Then you need to subscribe to these events:
messages.channels
, message.groups
for the New Channel Message
component
team_join
for the New User
component
Don't forget to hit Save Changes:
You can now use the appmixer.slack.list.NewChannelMessageRT component in a flow.
In order to migrate your Slack legacy app, go to Oauth & Permission section.
Then scroll down to Scopes and hit the Update Scopes button.
Ignore the first page, because that's all about scopes for bots.
Scroll all the way down and hit continue. You get to a second page with user scopes.
Select channels:read, channels:history, channels:write, groups:read, groups:write, groups:history, chat:write and users:read.
Verify the scopes and migrate the app.
And confirm. The Appmixer Slack module since version 4.2.1 is already updated and ready for the new Slack apps.
Flows that use the SendPrivateChannelMessage component won't work. The component will appear unauthenticated. The reason is a different Oauth scope in the new Slack app version. In this case, the user has to authenticate the component again.
https://twilio.com
First, you'll need to create an account on the Twilio website.
After signing up, go to https://console.twilio.com/
Copy the Account SID and Auth Token from the "Account Info". Alternatively you can navigate to the "API Keys & Tokens" section, SID and Auth Token are available there.
use the Auth Token and Account Token to authenticate the Twilio components in the Appmixer Designer.
Configure the Twitter.
Navigate to the and sign up if you haven't already.
You might be required to apply for a developer account where you'll need to provide some information about your intended use of Twitter’s API.
After logging in to your Twitter Developer account, navigate to the .
Twitter should automatically create a default project and application for you. If it doesn't, click "Create Project" and follow the prompts to set up a new one. After creating the project, you'll be able to create an application. Navigate to your project and select "Add App."
Update application details, such as the name, description, and icon, by clicking the "Edit" button. Next, configure the authentication settings.
Set the "App permissions" to "Read and write" and "Type of App" to "Web App"
Set the Redirect URI to https://[YOUR_API_BASE]/auth/twitter/callback
, for example https://api.appmixer.com/auth/titter/callback
Get the Client Id
and Client Secret
from the Keys and Tokens page
Configure the App Key as clientId
and the App Secret as clientSecret
in the service settings within the Backoffice, under the configuration ID appmixer:twitter
.
Sign up with Airtable:
Specify Table name
Now the Airtable workspace/base is prepared. Let's configure the OAuth app.
clientId
and clientSecret
into Appmixer Backoffice.The last step is to configure clientId and clientSecret in the Appmixer Backoffice for appmixer:airtable
Sign up with Asana:
To create an OAuth app with Asana, follow the oficial documentation: .
Take note of the application's client ID and the client secret (which should be protected as a password)
You will need to specify the App name
and Redirect URL
in this step.
The App name
can be anything you want.
The Redirect URL
should be the URL where Asana will redirect the user after they authorize your app. This depends on your environment, usually in the following format: https://api.qa.appmixer.com/auth/asana/callback
clientId
and clientSecret
into Appmixer Backoffice.The last step is to configure clientId and clientSecret in the Appmixer Backoffice for appmixer:asana
Follow the next link:
You need to register one more URL in order to use the OneDrive Javascript file picker:
And select both of these options:
And save the changes:
The next step is creating clientId and clientSecret:
Unfortunately, the secret has an expiration, you're going to have to create a new one in 2 years:
Use the furthest date possible:
You will get a new secret, copy the Value into the clipboard:
This is the clientSecret, the Microsoft Secret ID is the Appmixer clientId. These secrets need to be added into the Backoffice:
And add new keys:
The clientId is the _Application (client) ID f_rom the main page:
Then go to the API permissions section:
Choose Microsoft Graph:
Delegated permissions:
Type-in Files:
And select these two:
Then type-in offline and select this permission:
The final set of permissions:
When creating Typeform Oauth2 application (), you can choose between access tokens that do expire in a week and access tokens that do not expire.
The token expiration is new in Typeform. Appmixer components before version 4.2 cannot handle it.
If you're registering the Oauth application for version 4.2 or newer, you can decide if you want to use tokens that do expire or not. If you decide to go with Unlimited then you don't have to set anything in the Backoffice, it is the default behavior. On the other hand, if you want to use tokens that expire, you have to go to the Backoffice and set the useRefreshToken to true
for the appmixer:typeform
service.
Then you can use the One Week configuration.
Since version 4.2.1 you can configure the string that appears on the Trallo Oauth page.
If you don't do this, the Oauth page will show Appmixer by default.
To integrate Appmixer with Salesforce, you are going to need an app in your Salesforce account. You can either create a new one or use one that already exists.
To create an app, you have to login into . Once logged in, on the left menu, look up Platform Tools -> Apps -> App Manager. This will show you a list of your existing apps and provide the option to create a new one via the New Connected App on the top right side:
In the next screen, you will be requested to fill out some basic data about your new app. Look out for the API (Enable OAuth Settings) section. Tick the Enable OAuth Settings checkbox, and fill out the callback URL and scopes as shown in this screenshot:
Check the Require Secret for Web Server Flow, Require Secret for Refresh Token Flow and Enable Authorization Code and Credentials Flow checkboxes.
With your app ready, you can get the client id and secret required for integrate Salesforce into Appmixer. Go to the App Manager and search for your app in the list. On the dropdown in the right side, click the View option.
In the next screen, look out for API (Enable OAuth Settings) section and click on the Manage Consumer Details button. You should see now your client id (shown as Consumer Key) and secret (shown as Consumer Secret):
Now we can provide these values to Appmixer. Log into the Backoffice and go to the Configuration section. Create a configuration service for Salesforce as follows:
Finally, set the clientId (Consumer Key in Salesforce) and the clientSecret (Consumer Secret in Salesforce) like this:
login
—The authorization server must prompt the user for reauthentication, forcing the user to log in again.
consent
—The authorization server must prompt the user for reapproval before returning information to the client.
select_account
—If present, take one of the following actions.
If zero or one hint is available and the user is logged in, show the approval page without prompting for login.
If zero or one hint is available and the user isn’t logged in, prompt for login.
If more than one hint is available, show the account chooser.
By default, we use the login
option, but you can configure it through the Backoffice.
Login into the Backoffice, and go to the Services module. Then add a new service like this:
2. Add a promptType key, and set it to one of the supported values by Salesforce:
There is a built-in Tasks component RequestApprovalEmail. This component is more like a template, something you can use and built your own version that better fits into your platform. Although, even this component may be useful.
This component sends one email to the requestor and another email to the approver. It uses the Appmixer Mandrill account to do that. Those emails contain a few Appmixer related information - Reply-To, From Email, ... These can be configured using Backoffice.
The email contains an Appmixer logo by default, you can change that by setting logoURL key in the Backoffice and pointing that to your own product log.
https://linkedin.com
You need to start by creating a new app on the LinkedIn Developer platform. Visit https://developer.linkedin.com/ and log into your account. Once logged in, navigate to "MyApps", then click on "Create App". Fill in all necessary information like app name, app logo, app description, app privacy policy URL etc. You also need to fill the "Associated LinkedIn page". This is the LinkedIn page that will be associated with the app. If you don't have a LinkedIn page, you can create one by clicking on the "Create a LinkedIn Page" link.
Navigate to the "Auth" section where you will find OAuth 2.0 settings. Here, you can set the "Authorized Redirect URLs". Take note of the application's client ID and the client secret (which should be protected as a password)
You will need to specify the Redirect URL
in this step.
The Redirect URL
should be the URL where LinkedIn will redirect the user after they authorize your app. This depends on your environment, usually in the following format: https://api.ACME.com/auth/asana/callback
Configure scopes: Navigate to the "Products" section, request access to "Share on LinkedIn" and "Sign In with LinkedIn using OpenID Connect", once approved (it's instant approval), you will be able to see them on the top of the screen:
Set clientId
and clientSecret
into Appmixer Backoffice for appmixer:linkedin
Verification will enable scopes to be used in the LinkedIn Appmixer connector: "Advertising API", "Lead Sync API", "Conversions API" and "LinkedIn Ad Library". These scopes are not used in the current version of the LinkedIn connector, therefore it's not required. You can still perform the verification by sending the verification link generated in the "Settings" tab to the Super Admin of the page associated with the App.
Process estimated time: instant approval.
Appmixer offers built-in Weather components.
They use our API key by default. If you want to change that and use yours, you can do that using the Backoffice.
Log in to your Schoology server. Look at the top navigation bar and go to Tools > School Management.
In the new screen, click on Integrations in the left menu. Now click on the API tab. You should see your consumer key and secret. The secret is hidden, so you have to use the Reveal Existing Secret option.
Log into the Backoffice and go to the Services section. Add a new service configuration named appmixer:schoology
. After it is created, add the following configuration values:
Here is the explanation for each value:
baseUrl: The API base URL. Usually is https://api.schoology.com/v1, but there are some cases where it could be different.
consumerKey and consumerSecret: The consumer key and secret we got from the Schoology server.
domain: The subdomain part from your server. For example, if your server URL is https://example.schoology.com, then the domain value is just an example.
Go to and create a new app. Fill the application name and redirect URL ().
Get you client ID and clientSecret in the "Configuration" section
Go to the Appmixer BackOffice -> Configuration. Add new configuration: appmixer:xero
. Add your clientId
and clientSecret
keys.
All trigger components (for example NewInvoice
) use Xero webhooks. In order to use this component(s) in Appmixer, you have to register Appmixer's Xero URI in Xero first.
Fill the field Send notifications to with https://api.acme.appmixer.cloud/plugins/xero/webhooks
(replace acme
with your subdomain) and select the events you want to listen to.
Make sure to copy the Webhooks key and paste it to the Appmixer BackOffice -> Configuration -> appmixer:xero
-> webhookKey
field.
First, you need to set an Quickbooks key and endpoint through the Backoffice in order to provide the Quickbooks components to your customers. go to the https://developer.intuit.com/app/developer/dashboard to create a new app
Select the name and scope: \
Then you receive your clientID and clientSecret. Also add the redirect URL (https://api.appmixer.com/auth/quickbooks/callback) \
go the Appmixer BackOffice -> Configuration. Add new configuration: appmixer:quickbooks
Add your clientId and clientSecret keys
All trigger components (for example NewInvoice
) use QuickBooks webhooks. In order to use this component(s) in Appmixer, you have to register Appmixer's QuickBooks URI in QuickBooks first and set the webhook key in the Appmixer BackOffice.
Fill the field Endpoint URL with https://api.acme.appmixer.cloud/plugins/quickbooks/webhooks
(replace acme
with your subdomain) and select the events you want to listen to. Configure the event triggers you want to listen to.
Make sure to copy the Verifier Token and paste it to the Appmixer BackOffice -> Configuration -> appmixer:quickbooks
-> webhookKey
field.
Sign up with Zendesk:
Now you need to add an OAuth application in Settings. In Settings navigate to: Account > API & SDKs and its API section.
Click Add API client.
You need to specify the Client ID and redirect URLs. The redirect URL should be https://api.acme.appmixer.cloud/auth/zendesk/callback
(replace acme
with your subdomain).
Client ID and secret are generated automatically. Once your OAuth client is now ready, you can see it in the list of OAuth clients. Make sure to copy the client ID and secret.
clientId
, clientSecret
and subdomain
when connecting accountThe last step is to configure clientId, clientSecret and subdomain while connecting Zendesk Chat component in a flow.
Note that the subdomain
is the first part of your Zendesk URL. For example, if your Zendesk URL is https://mycompany.zendesk.com
, then your subdomain is mycompany
. In our example, the subdomain is acme
.
appmixer.utils.email
Appmixer offers a built-in component for sending emails from the platform.
The SendEmail component uses our Mandrill API KEY by default. It is recommended to change that to your own Mandrill API KEY if you want to keep using Mandrill as the email service provider. You can do that from the Backoffice. The service ID is appmixer:utils:email in this case. You can also change the default from email address which is set to no-reply@appmixer.com.
The SendEmail component is an example, how sending emails from Appmixer can be done. You can have your own mailing system which you would like to use or you would like to use a different third-party application. In such a case, you should remove the SendEmail component from the system and offer your users your own implementation.
To learn more about configuring connectors, please visit the section.
They have to be inserted into the Appmixer. You can use the to do that.
In order to use Google API Webhooks, you have to verify your domain ownership. More about domain verification can be found . If you use the Appmixer Self-Managed package and you run Appmixer on your own servers using your custom domain, you can use records to verify your domain ownership. Otherwise, if you are an Appmixer Hosted customer, you can use the to verify your Appmixer tenant domain (api.YOUR_TENANT.appmixer.cloud
) at Google.
Go to the Auth tab and copy&paste these values into the .
Create Hubspot configuration in the .
Then copy&paste the generated key and put it into the .
In order to use the Microsoft Dynamics 365 CRM connector, you'll need a Dataverse environment alongside your Microsoft account. You can review your environments in . If you don't have any environment there, you can start with a . From the list of available apps, select Dynamics 365 Sales. Once you complete the sign-up process, the CRM environment will be created.
set the Redirect URI to https://[YOUR_API_BASE]/auth/docusign/callback
, for example
Now your developer instance is ready and accessible: . Note that when creating a new account, your instance ID (dev180380
in this case) will be different.
Endpoint: https://<YOUR_API_BASE>/plugins/appmixer/servicenow/events
for example https://api.appmixer.com/plugins/appmixer/servicenow/events
Some components (New Channel Message
or New User
) use Slack Events API (). In order to use this components in Appmixer, you have to register Appmixer's Slack URI in Slack first.
Go to then choose your Appmixer app.
Go to your app settings ()
In Appmixer 4.2 the Slack module was upgraded. We did remove all the legacy API and switched to their newest API. For some time, it was possible to use the Appmixer Slack module with both legacy Slack apps and the new Slack apps. But the legacy apps are deprecated and will retire in August 2021 (). If you use the legacy Slack app, you either have to create a new Slack app or migrate the existing one.
To learn more about configuring connectors, please visit the section.
The Salesforce OAuth authentication offers several behaviors when users try to authenticate. This is the summary of the available options (taken from Salesforce ):
The default login URL is , this can be changed with a baseUrl.
The last thing is the PEOPLE_TASKS_DASHBOARD_URL environment variable that has to be set for the Appmixer engine. This URL will be used in the RequestApprovalEmail component to create links in the email that is sent to the approver. This has to point to a page in your application that will display the tasks. That is a page that implements the widget.
Go to then choose your Appmixer app. Navigate to the "Webhooks" section and add a new webhook.
For detailed steps, see .
Go to then choose your Appmixer app. Navigate to the "Webhooks" section either for the sandbox or production environment and add a new webhook.
For detailed steps, see .
Visit the Use App Events tutorial for more information.
appmixer.utils.ai
Appmixer AI utilities allows you to introduce AI functionality in your integrations, automations or simply extend your product with AI capabilities via Appmixer's No-Code Studio.
After installing the appmixer.utils.ai
module, go to the Backoffice to configure the OpenAI apiKey
for the module:
Additionally, you can also override the default OpenAI models for the SendPrompt
(default is "gpt-4o"
) and GenerateImage
(default is "dall-e-3"
) components:\
Configure the Zoho OAuth2 application.
Create a developer account by visiting https://www.zoho.com/developer/signup.html
Setup a Server-based Applications API client from Zoho API Console https://api-console.zoho.com
Fill in the client information
Once you created the client, the Cient ID
and Client Secret
will be generated, copy these to add in the Appmixer Backoffice.
There is one more configuration option for the Zoho module:
By default, this is set to 10 minutes (600000ms). All the Zoho components need a list of available fields per each module (contacts, leads). This list of fields is defined by the user and their CRM settings. In order to reduce the number of Zoho API requests during the flow design phase (and avoid the possibility of using all API credits), Appmixer the list of fields into a cache. The default TTL on this cache can be changed through the Backoffice.
The Language module uses by default Appmixer credentials. To overwrite them with yours, go to Backoffice and add the following settings:
Sign up with Zendesk: https://www.zendesk.com/register/
Now you need to add an OAuth application in Admin Center. In Admin Center navigate to: Apps and integrations > Connections > OAuth Clients.
Click Add OAuth client.
Now save the OAuth client and copy the client ID and secret. You will need them later.
Your OAuth client is now ready to be used and looks like this in the list of OAuth clients.
clientId
, clientSecret
and subdomain
into Appmixer Backoffice.The last step is to configure clientId, clientSecret and subdomain in the Appmixer Backoffice for appmixer:zendeskTickets
connector.
Note that the subdomain
is the first part of your Zendesk URL. For example, if your Zendesk URL is https://mycompany.zendesk.com
, then your subdomain is mycompany
. In our example, the subdomain is acme
.
Appmixer contains components that we use to test components. You can use them to test your own custom component. There is a ProcessE2EResults component which sends result from a test run (flow run) into a predefined list of email addresses.
It uses our Mandrill API KEY by default. You can change that in the Backoffice.