What are contacts useful for
Use contacts in Gorelo to manage:- Communication around tickets
- Asset associations
- Invoice recipients
- Client Portal access and permissions. See Give contacts access to the Client Portal.
Create and synchronize contacts
You can import contacts in Gorelo and synchronize them with external tools such as:- M365 & CyberDrain Improved Partner Portal (CIPP) Sync: Syncs licensed M365 users into Gorelo.
- Manual and CSV files: Manually add contacts or bulk import them from a CSV file.
- API: Send POST or PATCH requests to the
https://api.<region>.gorelo.io/v1/contactsGorelo API endpoint.
Import contacts
You can import your existing contacts as a CSV file in Settings > Import > select Contacts. To do so, the CSV must fulfill the following requirements:- The client associated with each contact in the CSV file must already exist in Gorelo.
- The client names in the CSV must match exactly the client names in Gorelo.
- Client names in Gorelo must be unique.
- Gorelo limits each import to a maximum of 1000 contacts.
Microsoft 365 sync via CIPP
Gorelo integrates Microsoft 365 via CyberDrain Improved Partner Portal (CIPP) to automate directory management and streamline contract billing. To set this up, configure API credentials within Gorelo’s integrations settings, such as:- Tenant ID
- Application ID
- Secret
- API URL
CIPP-API & MCP
Create an API client, generate credentials and sync with Gorelo.
- Synced (Licensed): Any end user assigned an active Microsoft 365 license (such as Microsoft 365 Business Premium or Exchange Online P1) automatically pulls into Gorelo as an active contact under their respective client organization.
- Excluded (Unlicensed): The native CIPP sync ignores unlicensed mailboxes (shared mailboxes, aliases) and doesn’t create any separate contact.
Dynamic quantities and contacts
Gorelo restricts native syncing to licensed users to fuel Dynamic Quantities in your client contracts. By syncing licensed seats via CIPP, you can configure mapping rules in your contracts that automatically calculate billing based on active users. Consider the following scenario:- A client hires a new employee and assigns them an M365 license.
- CIPP syncs the user into Gorelo.
- Gorelo automatically increments the contract seat count on your next billing run.
FAQ
Can I sync a single contact who has a licensed mailbox across two different domains?
Can I sync a single contact who has a licensed mailbox across two different domains?
Yes. CIPP pulls both in as separate contacts. You can safely merge these duplicates in Gorelo to keep ticket histories unified under a single contact record.
Can I still send an outbound email to a contact's secondary alias?
Can I still send an outbound email to a contact's secondary alias?
Yes. You can manually create a contact record for that address.