Create an API Key

API keys allow you to authenticate requests to the OpsFusion API. Follow this guide to create and manage your API keys.

Before You Begin

Ensure you have:

• Account Admin permissions in your OpsFusion organization
• A clear understanding of where you’ll use the API key (monitoring tool, script, etc.)

Security Best Practice

Treat API keys like passwords. Never commit them to version control or share them publicly.

Step 1: Navigate to API Keys

1. Click on your name in the top-right corner
2. Select Account from the dropdown
3. Click on the API Keys tile

Step 2: Create API Key

1. On the API Keys page, click the Create API Key button.
2. Fill in the API key details
   • Name - A descriptive name to identify this key’s purpose and location
   • Roles - Select the roles to grant the key
3. Click Create

Step 3: Copy and Store the API Key

One-Time Display Only

The API key will only be displayed once. After you close this dialog, you will never be able to view the key again. If you lose it, you must delete the old key and create a new one.

Action required:

1. Copy the key immediately
2. Store it in a secure location before closing the dialog
3. Verify you’ve saved it correctly

What’s Next?

Now that you have an API key:

• Review the Send Alerts documentation to learn how to use the API
• Integrate OpsFusion with your monitoring tools
• Set up alerts for critical services

Troubleshooting

401 Unauthorized Error?

• Verify the API key is copied correctly (no extra spaces)
• Check that the key hasn’t been deleted
• Ensure the Authorization header is formatted correctly

403 Forbidden Error?

• Check that you’re using the correct account ID in the URL

Can’t find API Keys page?

• Ensure you have Account Admin permissions
• Contact your organization administrator if you need access