Fastfold AI Docs - Enable Webhooks

Use this page to enable webhook automation at submit time.

Fold job payload (`POST /v1/jobs`)

Enable webhooks under constraints.webhooks.

Evolla webhook example

{
  "name": "Fold with Evolla webhook",
  "sequences": [{ "proteinChain": { "sequence": "MGLSD..." } }],
  "params": { "modelName": "boltz-2" },
  "constraints": {
    "webhooks": {
      "evolla": {
        "enabled": true,
        "initial_question": "What is the function of this protein?"
      }
    }
  }
}

OpenMM webhook example

{
  "name": "Fold with OpenMM webhook",
  "sequences": [{ "proteinChain": { "sequence": "MGLSD..." } }],
  "params": { "modelName": "boltz-2" },
  "constraints": {
    "webhooks": {
      "openmm": {
        "enabled": true,
        "preset": "single_af_go",
        "residue_profile": "calvados3",
        "temp": 293.15,
        "ionic": 0.15,
        "pH": 7.5,
        "step_size_ns": 0.01,
        "sim_length_ns": 10
      }
    }
  }
}

Custom HTTP webhook (per-run toggle)

{
  "constraints": {
    "webhooks": {
      "custom_http": {
        "enabled": true
      }
    }
  }
}

When URL/token are not provided in payload, FastFold resolves them from global custom webhook config when available.

Workflow payload (`POST /v1/workflows`)

For workflow runs (Evolla/OpenMM), enable custom webhook under workflow_input.webhooks.

{
  "workflow_name": "calvados_openmm_v1",
  "name": "OpenMM with webhook",
  "workflow_input": {
    "preset": "single_af_go",
    "name": "my-openmm-run",
    "webhooks": {
      "custom_http": {
        "enabled": true
      }
    }
  }
}

Default behavior notes

If global custom webhook is configured with enabled_by_default: true, new fold/workflow runs can emit webhook events even when no explicit webhook object is passed.
If webhook is enabled but not configured (missing URL/token), request validation can fail with a helpful setup error.

Enable Webhooks

Fold job payload (POST /v1/jobs)