Developer Portal

• Developer Portal accounts are created by invitation only. Corvus sends the invitation; developers cannot invite other developers from the portal.
• To invite a developer on your team, email api@corvusinsurance.com with their name and email address, and say whether they need sandbox access, production access, or both. Each environment sends its own invitation.
• The invitation email contains a link to set up the account. The link expires 7 days after it is sent. When you follow it, you create a password and set up multi-factor authentication, which is required to sign in.
• If the link has expired, email api@corvusinsurance.com for a new invitation.

• After signing in, select your API partner to see its details, including the brokerage ids it can submit for, the webhook URL, and the API key. The key is masked.
• Click Regenerate to create a new API key. The new key is displayed once it is created.

Sign in to the Developer Portal to see key rotation details.

• Click Edit next to the webhook URL, enter the new URL, and click Save. You can also change it with the updateWebhook mutation (see Update Webhook Url).
• The URL must start with https://, include a host, and contain no spaces or embedded credentials (such as https://user:password@example.com). Otherwise it is rejected with must be a valid HTTPS URL.

• The Webhook subscriptions card lists each webhook event type with a checkbox. Check an event to receive it and uncheck it to stop. Each change is saved as soon as you make it.
• Your partner is subscribed to every event type by default except Renewal Solicitation Open, which we turn on when your partner is enrolled in renewal webhooks. You receive a newly added event type only after you subscribe to it.
• The card warns you when no Webhook URL is set and when no events are selected. For what happens to an event you are not subscribed to, see Event subscriptions.

The sandbox Developer Portal has a Data Generation and Testing section. These tools are not available in production.

• Webhook Testing: Select an event, enter the id of the record to send it for, and click Test Webhook. A signed webhook for that record is sent to your saved webhook URL. Supported events are Cyber Risk Score Ready (client id), Quote Ready and Quote Declined (quote request id), Policy Bound and Policy Issued (quote request id and policy id), Renewal Solicitation (quote request id), and Policy Non-Renewal (policy id). Renewal webhooks are only sent if your account is enrolled in renewals. A webhook is only sent for an event your partner is subscribed to; otherwise the portal tells you it was not sent (see Event subscriptions).
• Seed Renewal Data: Choose a Coverage Ends Date and click Seed. This creates a Smart Cyber client with an issued expiring policy that ends on that date, plus its renewal quote request. The expiring policy number and the renewal quote request id are displayed so you can test Get Renewal Quote Request.
• The portal lists your quote requests and policies. You can search them by quote request id, policy id, or policy number. Three actions are available from the list:
  • Bind & Issue: Shown for a quote request with status QUOTES_SHARED that has no policy. It binds the first quote option and issues the policy, so you can test the Policy Bound and Policy Issued webhooks and Get Policy Documents.
  • Start Renewal: Shown for a bound or issued policy that has no renewal yet. It creates the renewal quote request and sends the Renewal Solicitation Open webhook.
  • Generate Quote: Shown for a renewal quote request that has not been quoted yet, such as one created with Seed Renewal Data. It generates the renewal quote the way an underwriter would and sends the Quote Ready webhook to your saved webhook URL, so you can test the renewal quote flow and your webhook handler end to end without waiting on Corvus. The portal reports whether the webhook was sent, skipped, or failed. Quote Ready for a renewal is only sent if your account is enrolled in renewals. You can only generate quotes for your own partner's renewals.