How to do my first test

Ensure you follow testing etiquette while doing a test

Following testing etiquette is crucial for providing the Curation Body with the needed context to support the testing process, saving the need for back-and-forth communication. Adhering to these guidelines should mitigate potential concerns and help Curation continue to uphold the principles of the POAP ecosystem.

If you are creating a POAP drop for testing purposes, follow this checklist:


Testing Checklist

If you are creating a drop for testing purposes, follow this checklist:

  • Mark the event as a private drop
    Since we don’t have a test environment and are testing directly in production, we ask that the event be set to "private". There’s a checkbox for this on the bottom left-hand side, above the save button.
  • Include the word "test" in your title
  • Include additional context in description
    Include the word test and detail around what type of test this is, and any additional context.**
  • Mark artwork as test
    Mark artwork as a test. Please avoid any artwork that is a stock image or could be copyright infringement. Do not reuse artwork intended for your actual drop as part of your test.
  • Request a minimal number of mint links
    While testing, we generally suggest requesting a minimal amount of mint links (less than 10). If your test needs more, please explain why in the description.
  • Use a real email address
    In case we have questions about this test and need to reach out.

Conducting multiple tests (above instructions still apply)

  • Title For multiple tests, include test 1 of 3, 2 of 3, 3 of 3 in the title.
  • Description Also indicate the number of tests in the description: 1 of 3, 2 of 3, 3 of 3. If multiple devs are doing tests, please also include that in the description.
  • Artwork Okay to reuse the image for test purposes.
  • Email Use the same email (not just the same domain, but the same user email) for all tests in case we have any questions about your tests and need to reach out.

For a better experience, we encourage using the POAP mint links (via POST /event/{id}/qr-codes) as your delivery method, especially for your first test.

What are POAP mint links?

Mint links are unique links that entitle collectors to mint one POAP via the standard POAP mint flow. Distributing mint links is one of the more secure methods of POAP distribution, as it's difficult for one person to secure multiple mint links.

Individual mint links are typically better for somewhat smaller POAP issuances, or for those that can automate the distribution using bots on Discord, an email marketing platform, or other tools. One of the advantages of using mint links is that cross-platform distribution is easy; however you plan to distribute, it should be as easy as handing collectors a URL. Optionally, this URL may be represented with a QR code (and/or printed) through a service like QRExplore. Another option for QR code distribution is using the Magic POAP QR Dispenser, which will allow you to display each POAP's mint QR in sequential order as they're scanned. This can be extremely handy for quickly and easily distributing POAPs during live, in-person events or even events that are streamed online.

Mint links are requested during the POAP drop creation process.

✅ Secure

🔴 Time-consuming to distribute one-by-one unless the Magic POAP Dispenser is used.

Steps to follow for the first test

Step 1: Use the POST /event/{id}/qr-codes to get the list of mint links available from your .txt file. This shows you a list of mint links for the specific drop. Mint links are provided to you after the POAP Curation Body gives your drop a positive review.

Step 2: Use the GET /actions/claim-qr to check the status of the mint
links. This allows you to check how many mint links are claimed.

Step 3: Use the POST /actions/claim-qr to allow a collector to mint a POAP by sharing a mint link from the .txt file in step 1.


You'll need the edit code to make changes to the event

You'll need to use the "secret" edit code to make any changes to the drop. This includes requesting additional mint links (if appropriate). The edit code is provided to you in the initial drop creation confirmation email. Please check your email for the edit code.

Additional considerations for testing:

Load Test - If you want to do a load test, please contact us. We do not encourage users to do load tests.

Additional documentation

How can I produce quality POAP drops

POAP Distribution Methods 101