Replace existing integrations
Replace existing integrations.
You already have vendor clients. Change those calls to Bitlync.
The ISV rewrites the calls. The MSP pastes keys once. Connect names a missing permission in the flow.
.raw is extra vendor fields on a read. .raw is read-only. vendor.native is the same payload. Ticket writes accept optional vendor_native.
Order: inventory, coverage, reads, writes. Webhooks only if we already have them. Reads first. Keep the old vendor clients until Bitlync matches in their environment. dry_run is the shadow pass on writes.
Device write runs when the MSP turns it on for your grant.
Tickets are two-way when the MSP grants it. You can create, update, and close. You can subscribe to events when the MSP changes the ticket in their PSA. Grants: psa.ticket.create, psa.ticket.update, psa.ticket.events. When a ticket is created, updated, noted, closed, or reopened, you can list those events or get a signed webhook. After a tenant sync, GET /tenants/{id}/connections/events?kind=ticket.closed (also created, updated, noted, reopened). Optional signed webhook. Grant is the connection (psa.ticket.events). Missing is grant_missing. When a device is created or updated, you can list those events or get a signed webhook. After a tenant sync, GET /tenants/{id}/connections/events?kind=device.updated (also created). Optional signed webhook. Grant is the connection (rmm.device.events). Missing is grant_missing. When a company is created or updated, you can list those events or get a signed webhook. After a tenant sync, GET /tenants/{id}/connections/events?kind=company.updated (also created). Optional signed webhook. Grant is the connection (psa.company.events). Missing is grant_missing. You can close a ticket once they accept the connection. Auto-close when a finding is fixed is a separate switch. Billing line items: quantity updates only, on lines the MSP matched on an existing agreement. Send them with POST /tenants/{tenant_id}/billing/quantities. Quantity 0 stops billing. Ending a line is refused. A write happens when you send the quantity (daily or monthly, as you set on the service). The MSP's change limit defaults to 25%, and a change over that limit waits. Bitlync never creates agreements or billing lines. Public word Agreement. Time: hours the caller states, on a linked ticket. PSA company create is not supported: companies are created by the MSP, and a PSA create returns 403 company_create_not_supported. Match to an existing company. A company create at a distributor, when the MSP has granted it, is a distributor create.
What we write lists the write paths and the error codes.