Webhooks

Webhooks allow RankYak to notify your system automatically whenever a new article is generated. This is ideal for custom publishing pipelines, internal tools, or platforms that need to react immediately to new content.

You can find the webhook documentation here: https://docs.rankyak.com/webhooks

🔗 Enabling webhooks

To set up a webhook:

1. Go to your project

2. Open Settings → Integrations

3. Scroll to the Developer zone

4. Click Enable next to Webhook

A popup will appear asking for the URL where RankYak should send the webhook. Enter the URL of the endpoint on your server or system that will receive the webhook data.

🔁 Using webhooks together with the Backlink Exchange

If you use webhooks to publish articles externally, and you want to participate in the backlink exchange, there is one additional step required.

After publishing the article on your website, you must send the live article URL back to RankYak via the API. This allows RankYak to:

• Know where the article is published

• Verify the article

• Include it in the backlink exchange network

You can find the API documentation for this here: https://docs.rankyak.com/api-reference/articles/store-external-url-for-an-article

Without providing the live URL, RankYak cannot assign or verify backlinks for that article.

🚀 When webhooks are sent

A webhook is triggered every time RankYak generates a new article. Your endpoint will receive a POST request containing article data in JSON format that you can use to:

• Publish the article to your CMS

• Store it in a database

• Trigger another automation

• Process it however you prefer

This gives you complete control over how new content is handled.

🧪 Testing webhooks

To make sure your webhook endpoint is set up correctly, RankYak allows you to manually send a webhook for an already generated article.

1. Open any generated article in RankYak

2. In the bottom-right corner, click the three dots

3. Select Send/Resend webhook

RankYak will immediately send the webhook payload for that article to your configured webhook URL.

You can use this to verify that:

• Your endpoint receives the request

• The payload is processed correctly

• Your automation or publishing logic works as expected

You can resend the webhook multiple times if needed, this won't affect the article or its status and is safe to use for testing.

❌ Disabling the webhook

If you no longer want to receive webhook notifications:

1. Go to Settings → Integrations

2. Find the Webhook section

3. Click Disable

This will stop RankYak from sending webhook events to your URL.

🎯 Summary

Webhooks allow you to:

• Receive article data instantly

• Build custom automations

• Integrate RankYak with any external system

• Trigger publishing or processing as soon as articles are generated

They offer maximum flexibility for developers and custom workflows.