Is there any way we can send JSON data when we use POST API call to trigger Azure webjob?

Question

Is there any way we can send JSON data when we use POST API call to trigger Azure webjob?

I have a webjob that needs to run when we call the Azure webjob webhook URL, which works fine, and I am successfully able to do a POST call in the Postman application using the given URL and credentials, which we can see when we click the webjob name. So the question is, can we send JSON data in the post call, and can we be able to fetch it inside the webjob? I used PHP to build the web job, and I checked the $_SERVER variable but was not able to find the JSON data that I sent in the call. I'm completely new to API, and please, anyone, give me advice.

Thanks,

Surya Narayanan Development Account 5 Reputation points

2025-05-14T04:56:27.8266667+00:00
Thank you so much. I tried exactly what you said, but the JSON string way is not working for me. I tried in the Postman application, pasted it like this below with raw JSON, but it still didn't work.

{ "arguments":"{\"name\":\"John\",\"age\":98}" }

But the query string option is working perfectly. My notion is this way of passing arguments in the URL is not safe, so I'm rethinking if is this safe as there is no other option. Can you please advise?
Surya Narayanan Development Account 5 Reputation points

2025-05-14T08:52:34.65+00:00

Thank you for your explanation. I'll encrypt and decrypt the data
Siva Nair 2,420 Reputation points Microsoft External Staff Moderator

2025-05-15T17:02:12.8733333+00:00

Hi Surya Narayanan Development Account,

Just checking back to see if Michele Ariis response was helpful and you get your issue resolve , do let us know if you need further assistance , happy to help you.

Thanks

2 answers

Your answer

Surya Narayanan Development Account 5 Reputation points

2025-05-14T04:56:27.8266667+00:00

Thank you so much. I tried exactly what you said, but the JSON string way is not working for me. I tried in the Postman application, pasted it like this below with raw JSON, but it still didn't work.

{ "arguments":"{\"name\":\"John\",\"age\":98}" }

But the query string option is working perfectly. My notion is this way of passing arguments in the URL is not safe, so I'm rethinking if is this safe as there is no other option. Can you please advise?
Surya Narayanan Development Account 5 Reputation points

2025-05-14T08:52:34.65+00:00

Thank you for your explanation. I'll encrypt and decrypt the data
Siva Nair 2,420 Reputation points Microsoft External Staff Moderator

2025-05-15T17:02:12.8733333+00:00

Hi Surya Narayanan Development Account,

Just checking back to see if Michele Ariis response was helpful and you get your issue resolve , do let us know if you need further assistance , happy to help you.

Thanks

Answer 1

Hi, the Kudu WebJobs API doesn’t forward the POST body to your job. The only data you can send is a single arguments string, either in the query-string or as a JSON property named arguments:

curl -u user:pwd \
  -H "Content-Type: application/json" \
  -d '{"arguments":"{\"orderId\":123,\"action\":\"ship\"}"}' \
  https://<site>.scm.azurewebsites.net/api/triggeredwebjobs/<job>/run

At run-time that string is exposed to the job as:

the environment variable WEBJOBS_COMMAND_ARGUMENTS, and

the first command-line argument ($argv[1]) for console apps.

So—wrap your JSON inside the arguments string and parse it in your PHP code:

$payload = json_decode(getenv('WEBJOBS_COMMAND_ARGUMENTS') ?: $argv[1], true);

Answer 2

Michele Ariis 2,040 MVP

/run only looks at the arguments query-string; the POST body is simply ignored, so the JSON trick will never fire the job.

POST .../triggeredwebjobs/<job>/run?arguments=%7B%22name%22%3A%22John%22%2C%22age%22%3A98%7D

That string turns up inside the job as WEBJOBS_COMMAND_ARGUMENTS (or argv[1]). The Kudu API spec shows the arguments parameter defined in=query, not in the body.

Is the query-string safe?

-The call is over HTTPS and you authenticate with the site-level credentials, so the data is encrypted in transit.

-It will appear in App Service access logs; if that bothers you, Base64-encode or encrypt the JSON before sending and decode inside the job.

If you really need a POST body, wrap the WebJob with your own API (Function/App Service) that accepts a JSON payload, then triggers the job internally – the native WebJob endpoint can’t do it.

Siva Nair 2,420 Reputation points Microsoft External Staff Moderator

2025-05-16T19:18:33.3533333+00:00

Hi Surya Narayanan Development Account,

Just checking back to see if Michele Ariis response was helpful, if its helpful Please click Accept Answer and kindly upvote it so that other people who faces similar issue may get benefitted from it.

Thanks

Share via

Is there any way we can send JSON data when we use POST API call to trigger Azure webjob?

2 answers

Your answer