API Infrastructure Upgrade

  • Updated

At Act-On, we want to be the most user-friendly, intelligent, and open marketing automation platform in the industry. As we continuously work to enhance and expand our API capabilities, we're excited to announce that we will be upgrading our API manager on December 11, 2023.

What's Changing

All traffic to the current API manager will be redirected to the upgraded API manager on December 11, 2023. You can wait until then and only update the Client ID and Client Secret values. Or you may choose to update your integration at any point by also updating the Base URL as well.

If you're not sure about when you should update your integration, the article Deciding When to Update Your API Credentials may help!

Updating your Application Before December 11

Prior to December 11, you will need to update the Base URL and use the new credentials (the OAUTH Client ID and Client Secret) to use when calling the /token endpoint.

Update the URL

The new manager supports two new Base URLs.

  • https://api.actonsoftware.com
  • https://api-eu.actonsoftware.com

Both Base URLs will route API traffic to any Act-On environment. The EU Base URL keeps all traffic on cloud computing resources hosted in the European Union, which is likely to be preferred for European customers running in Act-On's European-based infrastructure.

Update the Client ID and Client Secret

  1. In Act-On, go to Settings > Other Settings > Custom Account Settings > API Access Keys.
  2. Existing credentials are displayed here and new account credentials can be generated here if needed.
  3. Replace the existing Client ID and Client Secret in any /token call.
If you’re an Act-On partner, an agency customer with many accounts using the same integration, or an Integration Platform as a Service (iPaaS) provider, contact Support.

Examples:

These examples show the values for the Base URL, Client ID, and Client Secret directly in the cURL request. This is for illustration only and does not reflect the best practice to abstract those values into a separate configuration file that can be updated without requiring an update to your code.

For the Grant Type Password request, in this cURL code example...

curl -X POST https://restapi.actonsoftware.com/token -d 
'grant_type=password&username=john.doe@act-on.com&password=eodnhoj1
&client_id=OLD123abcdef&client_secret=OLD456ghijkl'

...update the Base URL, Client ID, and Client Secret (shown red > green)

curl -X POST https://api.actonsoftware.com/token -d 
'grant_type=password&username=john.doe@act-on.com&password=eodnhoj1
&client_id=NEW789mnopqr&client_secret=NEW012stuvwx'

 

For those using the older Grant Type Code request, in this cURL code example...

curl -X POST https://restapi.actonsoftware.com/token -H "Content-Type:
application/x-www-form-urlencoded" -d 'grant_type=authorization_code&code=
12345967-1234-1234-1234-1234567891234
&client_id=OLD123abcdef&client_secret=OLD456ghijkl&redirect_uri=https://localhost'

...update the Base URL, Client ID, and Client Secret (shown red > green)

curl -X POST https://api.actonsoftware.com/token -H "Content-Type:
application/x-www-form-urlencoded" -d 'grant_type=authorization_code&code=
12345967-1234-1234-1234-1234567891234
&client_id=NEW789mnopqr&client_secret=NEW012stuvwx&redirect_uri=https://localhost'

Updating your Application On or After December 11

On or after December 11, the existing Base URL will be redirected to the new Base URL. You will only need to update your application to use the new credentials (the OAUTH Client ID and Client Secret) when calling the /token endpoint. (For clarity, these are the same steps listed above.)

  1. In Act-On, go to Settings > Other Settings > Custom Account Settings > API Access Keys.
  2. Existing credentials are displayed here and new account credentials can be generated here if needed.
  3. Replace the existing Client ID and Client Secret in any /token call.

Updating Applications You Use But Don't Manage

If you use the API but don't manage the application code, you will need to reauthenticate once the application owner makes the changes explained above. For example, customers who use a third-party integration tool such as Zapier will need to reauthenticate with your Act-On username and password.

Once the application has made the upgrade, the connection will break and you will have to re-authenticate using your Act-On credentials within that partner service. If you experience any disruption in service, please try to re-authenticate first. If that doesn't work, contact the support team for help.

When Will This Change Happen

Your current Base URL and credentials will remain active until December 11, 2023.

Was this article helpful?

Have more questions? Submit a request