Requesting integration access¶
Last update · 3 min read
Ask RU4M to open Integrations for your companies. Once RU4M approves the request, you can create API keys and webhooks yourself.
Before you start¶
Only a company's Owner or Admin can send a request. A Manager, a Member and a custom role see the Integrations pages, but cannot request access.
One request covers every company of one owner. If you own a company you manage, that owner is you. Otherwise it is the owner of a company you manage, and the page names that owner. Companies the owner adds later are included automatically.
RU4M reviews every request. You get a notification and an email when RU4M decides.
Where to find it¶
- Select Integrations in the bar on the left.
You can also open Integrations directly.
Integrations carries a New badge until your first visit. Until RU4M approves access, every page in the Integrations panel is dimmed and shows a lock icon. Each of these pages opens the locked page.
The locked page shows the line API keys and webhooks for your companies. and a status badge, for example Not connected. A card below them tells you what to do next.
What the locked page tells you¶
| Card | Status badge | What it means | What you can do |
|---|---|---|---|
| Create a company first | Not connected | You do not belong to any company yet. | Select Create company. Read Creating and editing a company profile. |
| Ask an owner or admin | Not connected | Your role cannot request access. The card lists the Owner and Admin of your companies. | Ask one of those people to send the request. |
| … has no owner yet | Not connected | Your company has no owner, so nobody can request access. | Select Claim company. Read Claiming from Integrations. |
| Connect RU4M with your systems | Not connected | You can send a request. | Select Request access or Read the API docs. |
| Request sent | Request pending | RU4M is reviewing your request. | Wait for the decision, or select Withdraw request. |
| Request declined | Request declined | RU4M declined the request. The card shows the reason when RU4M gave one. | Wait until the date in Available again from {date}, then send a new request. |
Sending a request¶
- Open Integrations.
- Select Request access.
- Under What will you use it for?, select the closest match: CRM and sales, Analytics and reports, Website or your own app or Something else.
- Optionally, type a Message for RU4M. It can be up to 1000 characters long.
- Select Send request.
Next to the form, This request covers lists the owner's companies. What happens next explains the review.
After you send the request¶
The app confirms Request sent. and opens Integrations again. The status badge reads Request pending, and the Request sent card shows who sent the request, when, and for what.
When RU4M decides, you get a notification and an email. After an approval, the Integrations pages open. Continue with API keys and Webhooks.
Withdrawing a request¶
- Open Integrations.
- Select Withdraw request on the Request sent card.
- Select Withdraw request in the Withdraw the request? dialog.
The app confirms Request withdrawn. You can send a new request at any time.
When a request is declined¶
The status badge reads Request declined. The card shows RU4M's reason, when there is one.
Request access stays disabled for 7 days. The card shows the date in Available again from {date}. From that date, you can send a new request.
When access was revoked¶
RU4M can revoke access that it approved earlier. Your API keys then stop working, and your webhooks are paused.
The page shows the Connect RU4M with your systems card again, with the note Access was revoked on {date}. You can request it again. Send a new request the same way as the first one.
Revoked access is not the same as suspended access. While access is suspended, the Integrations pages stay open, but you cannot create or rotate keys or add webhooks. Read Overview, deliveries and audit.
Troubleshooting¶
You do not see Request access. Your role in the company is not Owner or Admin. The Ask an owner or admin card lists the people who can send the request.
Request access is disabled. RU4M declined your last request less than 7 days ago. Wait until the date the card shows.
The app asks "Discard the request?" You are leaving the request page before sending it. Select Stay to finish the request, or Leave anyway to drop it.
Related tasks¶
- API keys — create keys once access is approved.
- Webhooks — get notified when your events change.
- Company roles — who is an Owner or an Admin.