Diamra Developer Docs
All pages

Send the full report from your own email

A customer opens a project in your store, presses Share, types an email address and presses Send. Your team can do the same from your bench. Diamra then emails the project's full report to that address as a PDF, under your store's name. Your own system can send it instead, from your own address and in your own style.

  1. Pick project.report_requested on your endpoint, in the console under Webhooks.
  2. Open Diamra Email Delivery on the same page and turn project.report_requested off. Diamra stops sending its own email for it.
  3. When the event arrives, send your email to delivery_email. Attach the PDF from report_url, or make your own report from the rest of data.

What the event carries

The event fires once for each request, so two requests for the same project are two events. requested_by says who asked, and delivery_emailis the address they typed, which is not always the customer's own.

data holds the report as the customer sees it: the design, the views of the piece with their measurements, the price, the 3D model and the video. A part your store hides from customers is left out: its field is null, and views is an empty list. A measurement's from and to are points on its view's picture, as on the Measurements page. estimate has the fields of estimate.accepted. Every field is listed under project.report_requested.

Example body

Body of project.report_requestedJSON
{  "id": "4c1d7a52-9e0b-4f6a-8d3c-2b7e5a9f1c04",  "type": "project.report_requested",  "recipient": "customer",  "created_at": "2026-11-14T01:20:00Z",  "store": { "id": "a1b2c3d4-...", "subdomain": "yourstore" },  "data": {    "project_id": "...",    "design_image_id": "...",    "requested_by": "customer",    "delivery_email": "jane@example.com",    "report_url": "https://assets.diamra.com/project-reports/.../Your-Store-Project-4F2A.pdf",    "image_url": "https://assets.diamra.com/design-images/.../0.webp",    "views": [      {        "id": "...",        "view": "front",        "url": "https://assets.diamra.com/measure-projections/.../front.webp",        "measurements": [          {            "id": "...",            "type": "measurement",            "label": "Band width",            "mm": 6.4,            "text": null,            "from": { "x": 0.5, "y": 0.5 },            "to": { "x": 0.7, "y": 0.5 }          }        ]      }    ],    "estimate": {      "estimate_id": "...",      "price": 2450,      "currency": "USD",      "metal": "18K Gold",      "metal_color": "yellow",      "metal_options": [{ "metal": "Platinum", "price": 2900 }],      "piece_type": "ring",      "style": "halo_ring",      "setting": "prong",      "center_stone": { "type": "diamond", "shape": "round", "carat_weight": 1.0, "count": 1, "origin": "lab_grown" },      "total_carat_weight": 1.35,      "ring_size": 6.5,      "from": { "ring_size": "customer_answers", "metal": "customer_choice" },      "accepted_at": "2026-11-12T16:40:05Z"    },    "model_url": "https://assets.diamra.com/model-files/.../model.glb",    "video_url": "https://assets.diamra.com/video-clips/.../clip.mp4",    "customer": { "id": "...", "email": "jane@example.com", "phone": "+15551234567", "first_name": "Jane", "name": "Jane Doe" },    "salon_url": "https://yourstore.diamra.com/salon/projects/<design_image_id>",    "bench_url": "https://yourstore.diamra.com/bench/projects/<design_image_id>"  }}