API
서명 만들기
주소나 catch-all에 이름을 붙인 서명을 추가합니다.
POST/signatures
워크스페이스에 실제 호출을 실행합니다.
POST /signatures
주소나 catch-all에 이름을 붙인 서명을 추가합니다.
예시
settings:write가 필요합니다. address, name, html은 필수입니다.
curl -X POST "$OE/signatures" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "address": "[email protected]", "name": "Short", "html": "<p>Ada<br>Acme Ltd</p>", "isReplyDefault": true }'{ "object": "signature", "id": "sig_8f2c1a9b7d3e4f60a1b2c3d4", "address": "[email protected]", "name": "Short", "html": "<p>Ada<br />Acme Ltd</p>", "isDefault": false, "isReplyDefault": true, "createdAt": "2026-10-12T09:14:03.117Z", "updatedAt": "2026-10-12T09:14:03.117Z"}HTML은 발송 메일과 같은 방식으로 정리되므로 돌아오는 내용이 보낸 것과 다를 수 있으며, 텍스트나 이미지가 남아 있어야 합니다. 정리 전과 후 모두 최대 150,000자이며, 그렇지 않으면 호출은 422 signature_too_long입니다.
주소의 첫 번째 서명은 isDefault나 isReplyDefault가 false가 아닌 한 새 메일과 답장의 기본 서명이 됩니다. 이후의 서명은 요청할 때만 기본 서명이 되며, 그때는 그 자리를 가지고 있던 서명에게서 넘겨받습니다.
name은 1자에서 80자 사이이며 대소문자와 관계없이 그 주소 안에서 고유해야 합니다. 주소가 이미 쓰고 있는 이름은 409 signature_name_taken입니다. 주소 하나에는 서명을 최대 50개까지 둘 수 있고, 그다음 것은 422 signature_limit_reached입니다.
주소는 워크스페이스의 주소이거나, 이 워크스페이스의 검증된 도메인 중 catch-all이 켜진 도메인의 catch-all이어야 합니다. 도메인 전체를 포함해 그 밖의 것은 422 invalid_parameter입니다.