> For the complete documentation index, see [llms.txt](https://izaap-studios.gitbook.io/izaap-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://izaap-studios.gitbook.io/izaap-scripts/ads-jobs/exports-list.md).

# Exports List

## <mark style="color:$primary;">SERVER-SIDE</mark>

Server-side export that sends a fully custom AdsJob broadcast without requiring a saved job template.

```lua
exports['izaap_adsjob']:SendCustomAnnouncement(payload)
```

#### Description

This export is designed for external resources such as weather systems, emergency alerts, dispatch tools, automated announcements, or any other script that needs to send a styled AdsJob broadcast without depending on a player job or a saved AdsJob entry.

#### Parameters

```lua
| Field         | Type      | Required | Description                                            |
| ------------- | --------- | -------: | ------------------------------------------------------ |
| `message`     | `string`  |      Yes | The message that will be displayed in the announcement |
| `scope`       | `string`  |       No | Broadcast scope: `"global"` or `"job"`                 |
| `job`         | `string`  |       No | Required only when `scope = "job"`                     |
| `author`      | `string`  |       No | Custom author name shown in the announcement           |
| `label`       | `string`  |       No | Custom title/label shown at the top of the broadcast   |
| `color`       | `string`  |       No | Main title color in `#RRGGBB` format                   |
| `bodyColor`   | `string`  |       No | Message/body color in `#RRGGBB` format                 |
| `bg`          | `string`  |       No | Background image URL                                   |
| `logo`        | `string`  |       No | Logo image URL                                         |
| `showJobName` | `boolean` |       No | Shows the job name in the announcement                 |
| `hideAuthor`  | `boolean` |       No | Hides the author name in the announcement              |
```

```abap
### Possible Errors

* `empty_message`
* `invalid_color`
* `invalid_body_color`
* `invalid_bg_url`
* `invalid_logo_url`
* `missing_job_for_job_scope`
```

#### Notes

* Does not require a saved AdsJob entry in the database
* Does not send webhook logs
* Best option for weather systems, alerts, dispatch warnings, or automated announcements
* If `scope = "global"`, no job is required
* If `scope = "job"`, you must provide `job`

***

#### Example

```lua
local ok, result = exports['izaap_adsjob']:SendCustomAnnouncement({
    message = '⚠️ Storm warning: severe weather is approaching.',
    scope = 'global',
    author = 'Emergency Alert System',
    label = 'Weather Emergency',
    color = '#FFD54A',
    bodyColor = '#FFF4C2',
    showJobName = false,
    hideAuthor = false
})

### Full Example With Background and Logo


local ok, result = exports['izaap_adsjob']:SendCustomAnnouncement({
    message = '⚠️ Storm warning: severe weather is approaching. Please seek shelter immediately.',
    scope = 'global',
    author = 'Emergency Alert System',
    label = 'Weather Emergency',
    color = '#FFD54A',
    bodyColor = '#FFF4C2',
    bg = 'https://your-image-link.com/storm-background.jpg',
    logo = 'https://your-image-link.com/weather-logo.png',
    showJobName = false,
    hideAuthor = false
})
```