# Setup Apple Push certificate

Before you can send your first push message, you need to prepare your iOS app:

* Your app needs to be published successfully to the Apple app store
* You need to add a Push certificate to your app

There are two ways to find the wizard to create and upload your Apple Push certificate:

* **Push message** > New push message > Create new certificate

  <figure><img src="/files/BAwTwIYTD7lnVcaMzaIt" alt=""><figcaption><p>Add a Apple push certificate from the Push message screen</p></figcaption></figure>
* **Publish dashboard** > Apple App Store tile > View certificate & API keys > Apple push certificates > Add certificate<br>

  <figure><img src="/files/LerfAMQokFRlNMSNRh55" alt=""><figcaption><p>Add a Apple push certificate from the Publish > Certificates and API keys</p></figcaption></figure>

### Create Apple Push certificate

To create a new Apple push certificate you need to take the following steps:&#x20;

<figure><img src="https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/80113262259/original/JhF84w1BXOLWXej2VxhNEbZ5N0g_u3ZKrQ.png?1655240966" alt=""><figcaption></figcaption></figure>

1. Click the button to **Download your Apple push certificate signing request** file\
   It's a difficult name, but all you need to know is that it is a file which AppMachine creates for you.&#x20;
2. Remember the name of the Bundle Identifier in the grey box on this screen.
3. Click the **button at Step 2** in the AppMachine wizard.\
   This will open your developers account at Apple at the Identifiers screen. You might need to login before you will see that screen.\
   ![](https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/80111026613/original/_ByYu9sHe7CJnxJogV8kF6cBkRLtla2Zdg.png?1654631371)
4. **Search** for the row where the identifier matches the Bundle identifier name shown in the wizard page in AppMachine. Click on that row
5. Scroll down in the page Edit your app configuration till you see **Push notifications** and click the **Configure** button on that row

   <figure><img src="https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/80111015766/original/EnhX3Albn5yc0_vHlCttQy9S05oGAFaHpg.png?1654625264" alt=""><figcaption></figcaption></figure>

   <figure><img src="https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/80111015863/original/0SPlMWWWOiiy8pxTh5zsxjEo3cc9m85kxw.png?1654625280" alt=""><figcaption></figcaption></figure>

   <br>
6. Click on the **Second Create Certificate** button in the **Production SSL certificate area**\
   It's important that you choose the Production certificate, otherwise sending push messages won't work!\
   ![](https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/80149095061/original/A_h41Oz1CN4mGKDbhIkf5KASDLlEpHggfw.png?1665673152)
7. Click the **Choose File** button at the bottom\
   ![](https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/80111015936/original/J_0_BnlF1yLW5LSNYjEbhK1YwY4DMRsILg.png?1654625311)<br>
8. and **upload** the cert.SigningRequest file which you just downloaded from AppMachine in your Downloads folder\
   ![](https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/80111015979/original/lxTqfpC8QOyhowLHULokcBo4ikHVZFsAJA.png?1654625334)
9. Click **Continue**&#x20;
10. Click **Download**\
    ![](https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/80111016026/original/XNZoseeMrY7bdX32D4osCZaO99b7ZPrkLw.png?1654625370)
11. Activate the tab with AppMachine and click **Continue**
12. Click **Select File** and select the aps.cer file which you just download from Apple![](https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/80111016188/original/9rnDCXCVHSWzleh7CGBZhxapDBMMwHoQmA.png?1654625432)
13. Click **Upload**\
    ![](https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/80111016229/original/UVqeO0aPuERK9R-nnOa-SLl9gKWxPG6vvw.png?1654625458)
14. Congratulations, you just configured your Apple app to receive push messages.\
    ![](https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/80111016486/original/v-BQiyOAngDa027LXshg9T10JigvWUEmpw.png?1654625574)
15. Select **Push message** in the left side navigation to start sending your first Push message.\
    ![](https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/80111028435/original/3e3NNW-y9O4NmysQ18sovhz7F_WpnbC54A.png?1654632502)


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.appmachine.com/app-details/push-notifications/setup-apple-push-certificate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
