Unable to receive Forge webhooks, or unable to get them to fire

Question

I'm setting up an automated system to convert and visualise 3D models through the Forge APIs. The actual conversion and visualisation is pretty straight forward, but keeping track of the process is not as simple.

Autodesk recommends using webhooks, but documentation of this is quite sparse.

My main problem is that I'm unable to debug the webhooks. I get no indication to weather a hook has been posted or not.

I've read all of the similar questions here on stack overflow, in the FAQ and in the documentation (among others: Why is webhook workflow not taken into consideration when creating modelderivative job?).

I'm processing a conversion for a model with 'modelId'. And want to listen to the events 'extraction.updated'.

I'm registering a hook with a POST like this:

{
    "callbackUrl":"https://my-service.com/callbacks/modelId",
    "scope":{
        "workflow":"modelId"
    }
}

My job is registered like this:

{
    "input":{
        "urn":"{theUrnForTheModel}"
    },
    "output":{
        "formats":[
            {
                "type":"svf",
                "views":[
                    "3d",
                    "2d"
                ]
            }
        ]
    },
    "misc":{
        "workflow":"modelId"
    }
}

From what I can see the hooks never fire. I don't get any errors or indications that something fail on my server.

Am I required to post hookAttribute when creating the hook? This is documented as not mandatory. Am I required to have a fixes endpoint on my end, or is it ok to include the specific model id in the url?

Answer 1

A few points to check:

1. What's the response on POST hook? Should return 201
2. Which verb does your /callbacks/modelId accepts? Should accept POST
3. Have you tried extraction.finished event?