> For the complete documentation index, see [llms.txt](https://help.join.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.join.com/post-and-promote-jobs/job-boards/bundesagentur-fur-arbeit.md).

# Bundesagentur für Arbeit

Connect JOIN to Bundesagentur für Arbeit so your jobs are sent to the BA for free: get the cooperation agreement and certificate, then set it up in JOIN.

The Bundesagentur für Arbeit (BA) is Germany’s national employment agency and runs a job board for the whole country. Through JOIN’s integration, you can automatically transfer your open jobs to the BA for free, so they are visible to job seekers there.

After activation, all jobs you publish through JOIN will automatically be transferred to the BA. Candidates who find your job on the BA apply through your job ad on JOIN, so their applications arrive in JOIN, where you can manage them as usual.

{% hint style="info" %}
**Who can use this**

* **Plans:** All plans
* **Roles:** System Admins
* **Company location:** Germany
  {% endhint %}

JOIN acts only as a transmitter. The BA may contact you directly if a job does not meet their posting requirements.

## Details about BA

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Type</strong></td><td>Generalist</td></tr><tr><td><strong>Target group</strong></td><td>All professions</td></tr><tr><td><strong>Posting types</strong></td><td>Organic multiposting</td></tr><tr><td><strong>Region</strong></td><td>Germany</td></tr></tbody></table>

{% hint style="warning" %}
To display your job postings on Arbeitsagentur via JOIN, ensure that your cooperation agreement with BA is current (it renews annually) and that the BA integration is activated in your JOIN account. See [Activate the BA integration in JOIN](#activate-the-ba-integration-in-join).
{% endhint %}

***

## Requirements for integration

Before you can activate the integration in JOIN, you must complete the following steps with the Federal Employment Agency directly. JOIN cannot take these actions on your behalf.

{% stepper %}
{% step %}

### Register as a company

If you do not yet have an employer account or employer number with the BA, register on the [Bundesagentur für Arbeit website](https://www.arbeitsagentur.de/). Your employer account must hold the status "betreut" (supervised). To achieve this, contact the Employer Service of the BA, call your assigned contact person, and request that your account be marked as "betreut" in their Verbis system.
{% endstep %}

{% step %}

### Request a cooperation agreement

To enable XML data transmission, you need a cooperation agreement from the BA. Send an email request to:

`Zentrale.VAM-AccountMgmt@arbeitsagentur.de`

You can use the following template:

> **Subject:** Request for Cooperation Agreement for HR-BA-XML Interface
>
> **Text:**\
> Dear Sir or Madam,<br>
>
> We would like to transmit our job postings via the HR-BA-XML interface in the future. Please send us the necessary cooperation agreement (agreement for the use and processing of data, information, and services of the Federal Employment Agency via an XML interface).\
> Our employer number is: \[XXXX]\
> Contact person at the Federal Employment Agency: \[XXXX]\
> Contact information / Address: \[XXXX]<br>
>
> Best regards,\
> \[Your Name / Company]
> {% endstep %}

{% step %}

### Sign and return the agreement

After you return the signed cooperation agreement, the BA will send you:

* Link to download the certificate
* Link to the certificate password
* Allianz Partner Number
* Customer Number (10-digit)
* Supplier ID
  {% endstep %}
  {% endstepper %}

***

## Activate the BA integration in JOIN

Once you have received your credentials, you can enable the integration in JOIN:

1. In JOIN, go to `Settings`, select `Integrations` under `Platform`, then select `Bundesagentur für Arbeit`.
2. Upload your certificate file (note: issued annually, keep this updated).
3. Enter your certificate password in `Certificate PIN`.
4. Fill in `Alliance partner number (Allianzpartner)`, `Customer number (Kundennummer)` (10 digits) and `Supplier ID`.
5. Click `Save changes` to activate the integration.

<a href="https://join.com/settings/integrations?modal=external-profile&#x26;slug=arbeitsagentur.de" class="button primary">Connect Bundesagentur für Arbeit</a>

<div data-with-frame="true"><figure><img src="https://1825767176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEdFjOFlkC1DEfDv3nGRh%2Fuploads%2FlAFSaaXj59mT6iVIlSAI%2Fimage.png?alt=media&amp;token=fcef4afe-8329-4ba2-9434-19dfc3188908" alt=""><figcaption></figcaption></figure></div>

Once connected, you’ll see the integration marked as `Connected` in your JOIN account.

{% hint style="warning" %}
**Keep your cooperation agreement active.** The BA cancels your cooperation agreement if:

* The integration is not set up in JOIN within 3 months of both parties signing the agreement
* You do not request a new certificate within 3 months of your yearly certificate expiring
* The integration is not used for 6 months

If the agreement is cancelled, your jobs are no longer transferred to the BA and you need to request a new agreement.

Your certificate is valid for one year. JOIN sends you a reminder email every year before it expires, so you can renew it with the BA and upload the new certificate in JOIN in time.
{% endhint %}

***

## Job quality guidelines

Your job ad may be rejected by the BA if:

* The job location and federal state do not match
* The job is for a training position, but your company is not registered as a training provider
* The advert contains discriminatory language or content

If a posting is rejected, you can edit the job in JOIN, and we will forward the updated version to the BA. If errors occur during transmission, and the ad displayed on the BA does not match your version in JOIN, contact our support team.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.join.com/post-and-promote-jobs/job-boards/bundesagentur-fur-arbeit.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
