RidgeCRM Developer Docs

Guides

Guide: build a trigger

Create a source-owned JavaScript handler for record automation.

Recipe

  • Pick the object and event, such as Lead after create.
  • Register a handler key in source code.
  • Create or activate a platform trigger definition for that key.
  • Test with a real record in an isolated org.
  • Log results and make failures visible to operators.

javascript

Lead enrichment example

registerPlatformTriggerHandler('lead.enrich.afterCreate', async ({ record, prisma, orgId }) => {
  await prisma.task.create({
    data: {
      organizationId: orgId,
      subject: `Research ${record.company || record.email}`,
      status: 'TODO',
      priority: 'NORMAL',
      leadId: record.id
    }
  });
});